Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Zotero Bridge

by Combjellyshenversion 1.0.3i★ 10iRuns on your computerRepository ↗
Registry nameio.github.Combjellyshen/zotero-bridge

How to install

What it does

MCP Server for Zotero SQLite Database - collection, tagging, PDF reading and more.

  • Connects Runs on your computer
  • Account or key No key needed
  • Category Databases & datasets

Use together with

Skills that teach the AI this kind of work; they work alongside this one

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

by google-research★ 35,6291 skills

Skill · How-to guide

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

by BigBodyCobain★ 11,6021 skills

Skill · How-to guide

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

by gosom★ 8,2091 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity12/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness3/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score15/100

Quality: Passed 2/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Zotero Bridge. Follow https://mcp.popnx.com/i/combjellyshen-zotero-bridge.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 2/3 checks · Runs on your computer · ✓ Commands checked Nov 13, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Zotero Bridge for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "zotero-bridge": { "command": "npx", "args": [ "-y", "zotero-bridge" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Zotero Bridge tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  3. Paste these settings and save the file

    {
      "mcpServers": {
        "zotero-bridge": {
          "command": "npx",
          "args": [
            "-y",
            "zotero-bridge"
          ]
        }
      }
    }
  4. Quit Claude and open it again

  5. Try it

    Use Zotero Bridge and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Zotero Bridge or shows a Zotero Bridge tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Zotero Bridge yet

Zotero Bridge runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Zotero Bridge

  • Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • Install Node.js on your computer first (one time)
  • Install Node.js on your computer first (one time)
  • Install Node.js on your computer first (one time)

B · Others in Databases & datasets that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Zotero Bridge for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user zotero-bridge -- npx -y zotero-bridge 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Zotero Bridge tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  3. Paste this command and press Enter

    claude mcp add --scope user zotero-bridge -- npx -y zotero-bridge
  4. Type /mcp in Claude Code

    You should see Zotero Bridge listed as connected

  5. Try it

    Use Zotero Bridge and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Zotero Bridge or shows a Zotero Bridge tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Zotero Bridge for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "zotero-bridge": { "command": "npx", "args": [ "-y", "zotero-bridge" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Zotero Bridge tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  3. Open the AI chat in Cursor in Agent mode

  4. Try it

    Use Zotero Bridge and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Zotero Bridge or shows a Zotero Bridge tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Zotero Bridge for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "zotero-bridge": { "type": "stdio", "command": "npx", "args": [ "-y", "zotero-bridge" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Zotero Bridge tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  3. Open the AI chat in VS Code in Agent mode

  4. Try it

    Use Zotero Bridge and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Zotero Bridge or shows a Zotero Bridge tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Zotero Bridge💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user zotero-bridge -- npx -y zotero-bridge

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "zotero-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "zotero-bridge"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "zotero-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "zotero-bridge"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "zotero-bridge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "zotero-bridge"
      ]
    }
  }
}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
33/wk
Connection
Runs on your computer
Latest versioni
1.0.3
Published to registryi
Feb 1, 2026
Code last changedi
May 2, 2026
Maker
Combjellyshen
Packages
npm: zotero-bridge
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account Combjellyshen, which owns the repo

  • ! Caution

    Still maintained

    Code last changed 7 months ago, more than 6 months ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for zotero-bridge@1.0.3

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/combjellyshen-zotero-bridge.svg)](https://mcp.popnx.com/en/servers/combjellyshen-zotero-bridge)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Databases & datasetsi

  • More stars than 93% of the other 1235 servers in this category
  • Published to the registry more recently than 3% of the other 1235 servers in this category
  • Basic checks equal to or better than 50% of the other 1235 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Zotero Bridge safe?

It passed 2 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 7 months ago, and the latest version (1.0.3) reached the registry 10 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: QueryWeaver, Supabase, Neon, DBCode, Keboola MCP

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

QueryWeaver

An MCP server for Text2SQL: transforms natural language into SQL using graph schema understanding.

by FalkorDBGrowing★ 1.1KUpdated 14 months ago

Runs on your computer✓ falkordb.com

Supabase

Supabase’s official server lets AI create tables, query data and review project settings in your Supabase database.

by supabaseWidely used↓ 245.5K/wk★ 3K Stars for the whole repoUpdated yesterday

Computer or cloud✓ service owner · supabase.com

Neon

Official Neon MCP server for managing Neon projects and Lakebase Postgres databases.

by neondatabaseGrowing★ 666Updated 13 days ago

Runs in the cloud✓ service owner · neon.com

DBCode

Query and explore 100+ databases through your DBCode connections.

by dbcodeioEarly↓ 118/wk★ 368 Stars for the whole repoUpdated 2 months ago

Runs on your computer✓ service owner · dbcode.io

Keboola MCP

Connect your AI assistants to Keboola and expose your data, transformations, SQL queries, ...

by keboolaGrowing↓ 1.4K/wk★ 84Updated 3 days ago

Computer or cloud✓ service owner · keboola.com
Compared with similar ones
This one
Zotero Bridge
QueryWeaverSupabaseNeonDBCodeKeboola MCP
Runs whereInstalls on your computerInstalls on your computerCloud or install on your computerRuns in the cloud, nothing to installInstalls on your computerCloud or install on your computer
Needs a keyNoNoYesNoNoNo
Add with + in ClaudeNoNoYesYesNoNo
Basic checks2/33/35/55/52/35/5
LicenseMITAGPL-3.0Apache-2.0MITNOASSERTIONMIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

ZoteroBridge

🇨🇳 简体中文 | 🇬🇧 English

连接 Zotero SQLite 数据库的模型上下文协议 (MCP) 服务器

概述

ZoteroBridge 是一个模型上下文协议 (MCP) 服务器,可直接连接到 Zotero 的 SQLite 数据库 (zotero.sqlite),让 AI 助手(如 Claude、ChatGPT、GitHub Copilot 等)能够与您的 Zotero 文献库进行交互。

主要特性
  • 🗂️ 文件夹管理 - 创建、重命名、移动和删除 Zotero 文件夹(集合)
  • 🏷️ 标签管理 - 为文献添加、删除和查询标签
  • 📖 条目操作 - 搜索条目、获取详情、管理文件夹关系
  • 📝 内容管理 - 读取/设置摘要,添加笔记
  • 📄 PDF 处理 - 提取全文、生成摘要、全文搜索、获取标注
  • 🔍 标识符搜索 - 通过 DOI、ISBN、PMID、arXiv、URL 查找文献
  • 🔗 相关条目 - 查找手动关联、共享标签/作者的相似文献
  • 🛠️ 库维护 - 查找重复项、验证附件、清理孤立记录、合并条目

更新日志

v1.1.5 (2026-02-01)

🗑️ 回收站识别功能

  • ✅ 所有查询函数现在正确排除 deletedItems 表中的条目
  • ✅ getItemDetails 新增 isDeleted 和 dateDeleted 字段
  • ✅ findItemByDOI/ISBN/Identifier 自动跳过回收站中的条目
  • ✅ 新增 isItemDeleted() 方法检查条目是否在回收站
  • ✅ 新增 getDeletedItems() 方法获取回收站内容
  • ✅ 新增 getDeletedItemsCount() 方法获取回收站条目数量
  • ✅ 附件查询也排除已删除的附件
v1.1.3 (2026-02-01)

🔧 修复

  • ✅ 修复了集合(文件夹)创建功能 - 添加了必需的 clientDateModified 字段
  • ✅ 修复了集合重命名功能 - 正确更新 clientDateModified 时间戳
  • ✅ 修复了集合移动功能 - 确保父子关系正确建立
  • ✅ 所有集合操作现在完全符合 Zotero 官方数据库规范

现在可以正常使用:

  • 创建新集合(顶级文件夹)
  • 创建子集合(支持多层嵌套)
  • 重命名集合
  • 移动集合到其他父集合
  • 获取子集合列表
v1.1.2
  • 改进数据库连接稳定性
  • 优化错误处理机制
v1.1.0
  • 将 42 个工具整合为 13 个基于动作的工具
  • 简化接口同时保持全部功能

快速开始

前置要求
  • Node.js 18.0 或更高版本
  • Zotero 7.0 或更高版本
  • 支持 MCP 的 AI 客户端(如 Claude Desktop、Cursor、VS Code Copilot)
安装方式
从源码构建
# 克隆仓库

git clone https://github.com/Combjellyshen/ZoteroBridge.git cd ZoteroBridge

安装依赖

npm install

构建项目

npm run build

配置 AI 客户端
Claude Desktop

添加到 Claude Desktop 配置文件:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{

"mcpServers": { "zotero-bridge": { "command": "npx", "args": ["-y", "zotero-bridge"], "env": {} } } }

如果从源码构建:

{

"mcpServers": { "zotero-bridge": { "command": "node", "args": ["path/to/ZoteroBridge/dist/index.js"], "env": {} } } }

Cursor IDE

在项目根目录创建 .cursor/mcp.json:

{

"mcpServers": { "zotero-bridge": { "command": "npx", "args": ["-y", "zotero-bridge"] } } }

VS Code Copilot
  1. 打开 VS Code 设置 (Ctrl+,)
  2. 搜索 github.copilot.chat.mcpServers
  3. 点击 "在 settings.json 中编辑"
  4. 添加以下配置:
"github.copilot.chat.mcpServers": {

"zotero-bridge": { "command": "npx", "args": ["-y", "zotero-bridge"] } }

自定义数据库路径

如果您的 Zotero 数据库不在默认位置:

{

"mcpServers": { "zotero-bridge": { "command": "npx", "args": ["-y", "zotero-bridge", "--db", "D:/MyZotero/zotero.sqlite"] } } }


可用工具(13 个工具)

manage_collection - 文件夹管理

管理 Zotero 文件夹(集合)的所有操作。

动作描述
list列出所有文件夹
get获取文件夹详情
create创建新文件夹
rename重命名文件夹
move移动文件夹到新父级
delete删除文件夹
get_subcollections获取子文件夹
add_item将条目添加到文件夹
remove_item从文件夹移除条目
get_items获取文件夹中的所有条目
manage_tags - 标签管理

管理标签的所有操作。

动作描述
list列出所有标签
get_item_tags获取条目的所有标签
add为条目添加标签
remove从条目移除标签
create创建新标签
search_items - 搜索条目

按标题搜索 Zotero 条目。

get_item_details - 获取条目详情

通过 ID 或 Key 获取条目的详细信息。

manage_item_content - 内容管理

管理条目的摘要和笔记。

动作描述
get_abstract获取条目摘要
set_abstract设置条目摘要
get_notes获取条目笔记
add_note为条目添加笔记
manage_pdf - PDF 操作

PDF 文件的各种操作。

动作描述
extract_text从 PDF 提取全文
get_summary获取 PDF 摘要信息
list获取条目的 PDF 附件列表
search在 PDF 中搜索文本
generate_abstract从 PDF 内容生成摘要
find_by_identifier - 标识符搜索

通过各种标识符查找文献,支持自动检测。

类型描述
doi通过 DOI 查找
isbn通过 ISBN 查找
pmid通过 PubMed ID 查找
arxiv通过 arXiv ID 查找
url通过 URL 查找
auto自动检测标识符类型
get_annotations - 获取标注

获取 PDF 标注(高亮、笔记等),支持按类型、颜色筛选或搜索。

search_fulltext - 全文搜索

在 Zotero 全文索引中搜索或获取附件的全文内容。

find_related_items - 查找相关条目

通过多种方式查找相关文献。

方法描述
manual获取手动关联的条目
tags通过共享标签查找
creators通过共享作者查找
collection在同一文件夹中查找
all使用所有方法查找
get_database_info - 数据库信息

获取 Zotero 数据库信息(路径、存储位置、统计数据)。

raw_query - 原始 SQL 查询

执行原始 SQL 查询(仅支持 SELECT,只读)。

library_maintenance - 库维护 🆕

维护和清理 Zotero 库的工具。

动作描述
find_duplicates查找重复条目(按标题、DOI 或 ISBN)
validate_attachments验证附件文件是否存在
get_valid_attachment获取条目的有效附件
find_with_valid_pdf查找有有效 PDF 的条目
cleanup_orphans清理孤立的附件记录(支持 dry-run)
merge_items合并重复条目

使用示例

与 Claude/Copilot 配合使用
# 搜索文献

搜索标题中包含"深度学习"的条目

获取详情

获取 itemID 为 1234 的条目详细信息

管理文件夹

创建一个名为"机器学习论文"的新文件夹 将条目 1234 添加到文件夹 5678

PDF 操作

提取附件 ID 为 100 的 PDF 全文 在这个 PDF 中搜索"neural network"

通过 DOI 查找

查找 DOI 为 10.1126/science.aaa2397 的文献

获取标注

获取条目 1234 的所有高亮标注

库维护

查找我的库中的重复条目 检查条目 1234 的附件是否有效


项目结构

ZoteroBridge/

├── src/ │ ├── index.ts # MCP 服务器入口 │ ├── database.ts # Zotero SQLite 数据库操作 │ ├── pdf.ts # PDF 处理模块 │ └── tools.ts # MCP 工具定义(13 个整合工具) ├── dist/ # 编译输出 ├── test/ # 测试文件 ├── package.json ├── tsconfig.json └── README.md


开发指南

开发模式
# 监听文件变化并自动编译

npm run dev

构建
npm run build
命令行参数
# 显示帮助

zotero-bridge --help

指定数据库路径

zotero-bridge --db /path/to/zotero.sqlite

只读模式

zotero-bridge --readonly


注意事项

  1. 关闭 Zotero:使用写入功能时,请关闭 Zotero 客户端以避免数据库锁定
  2. 备份数据:在进行修改前备份 zotero.sqlite
  3. 只读模式:仅读取数据时使用 --readonly 参数更安全
  4. 附件验证:使用 library_maintenance 的 validate_attachments 检查文件是否存在

更新日志

v1.1.4 (2026-02-01)

🔧 重要修复 - 数据库兼容性

  • ✅ 修复重复项查询不一致问题 - findItemByDOI/ISBN 现在始终返回最新修改的条目
  • ✅ 修复 itemTags.type 字段 - 该字段为 NOT NULL,必须提供值
  • ✅ 动态获取 note/attachment 的 itemTypeID,不再硬编码
  • ✅ 所有查询现在排除 deletedItems 表中的已删除条目

🚀 新功能

  • ✨ 添加事务支持 (beginTransaction/commitTransaction/rollbackTransaction)
  • ✨ mergeItems 现在使用事务保证数据一致性
  • ✨ mergeItems 新增附件转移功能
  • ✨ 重复项查询现在返回 _duplicateWarning 警告信息

🛡️ 安全性改进

  • 所有写操作前检查 Zotero 进程状态
  • 自动创建数据库备份
  • 批量操作使用事务保护
v1.1.2 (2025-02-01)
  • 更新所有依赖到最新版本
  • 修复 Zod 4.x 兼容性问题
  • 修复 pdf-parse 2.x ESM 导入问题
v1.1.1 (2025-02-01)
  • 将 42 个工具整合为 13 个基于动作的工具
  • 新增 library_maintenance 工具(重复检测、附件验证、孤立清理、条目合并)
v1.1.0
  • 初始整合版本

📄 许可证

本项目采用 MIT 许可证。


🙏 致谢


📬 联系方式

欢迎提交 Issue 或 Pull Request!