Zotero Bridge MCP server

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\claudedesktopconfig.json macOS: ~/Library/Application Support/Claude/claudedesktopconfig.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 文件夹（集合）的所有操作。

manage_tags - 标签管理

管理标签的所有操作。

Shortened. The full README is on GitHub.