Zotero Bridge

io.github.Combjellyshen由 GitHub 帳號 Combjellyshen 發布v1.0.3更新於 Oct 24, 2026

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

已驗證STDIO僅桌面資料庫檔案與儲存知識與記憶

概覽

AI 產生的概覽

讓助理透過 SQLite 資料庫讀寫本機 Zotero 文獻庫，包括資料夾、標籤、筆記、PDF 與文獻檢索。

可以做什麼
ZoteroBridge 直接連接 Zotero 的 SQLite 資料庫（zotero.sqlite），提供 13 個工具。它可以列出、建立、重新命名、移動與刪除資料夾（集合）；新增、移除與查詢標籤；搜尋條目並取得詳細資料；讀取與設定摘要、新增筆記；擷取 PDF 全文、在 PDF 中搜尋並取得標註；透過 DOI、ISBN、PMID、arXiv 或 URL 查找文獻；尋找相關條目；以及執行重複項查找、附件驗證與條目合併等資料庫維護作業。raw_query 工具僅執行唯讀的 SELECT 查詢。
適用情境
適合以 Zotero 管理文獻、希望助理直接搜尋文獻庫、摘要或標註論文、整理資料夾與標籤、清理重複條目的使用者。特別適合在寫作或寫程式的同一個對話中處理文獻工作的桌機使用者。
執行需求
以 npm 套件 zotero-bridge 透過 stdio 在本機執行，需要 Node.js 18 或以上版本、Zotero 7.0 或以上版本，以及支援 MCP 的用戶端（例如 Claude Desktop、Cursor、VS Code Copilot）。僅支援桌機，沒有網頁版。未宣告帳號、API 金鑰或環境變數。可用 --db 參數指定自訂資料庫路徑。
安裝前請注意
寫入操作會修改真實的 Zotero 資料庫：資料夾、標籤、摘要、筆記與合併都可能被變更或刪除，cleanup_orphans 與 merge_items 具破壞性。寫入前請關閉 Zotero 用戶端以避免資料庫鎖定，先備份 zotero.sqlite，唯讀使用時建議加上 --readonly 參數。raw_query 僅限 SELECT 語句。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Zotero Bridge，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

ZoteroBridge

🇨🇳 简体中文 | 🇬🇧 English

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

[npm version] [Zotero] [Node.js] [TypeScript] [MCP] [License]

概述

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）

安装方式

从源码构建
bash
# 克隆仓库git clone https://github.com/Combjellyshen/ZoteroBridge.gitcd 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

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

如果从源码构建：

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

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

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. 添加以下配置：
json
"github.copilot.chat.mcpServers": {  "zotero-bridge": {    "command": "npx",    "args": ["-y", "zotero-bridge"]  }}
自定义数据库路径

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

json
{  "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

开发指南

开发模式

bash
# 监听文件变化并自动编译npm run dev

构建

bash
npm run build

命令行参数

bash
# 显示帮助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！

來源：README.md，提交 d34ec52

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.3最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分