ZoteroBridge
ZoteroBridge 是一个模型上下文协议 (MCP) 服务器,可直接连接到 Zotero 的 SQLite 数据库 (zotero.sqlite),让 AI 助手(如 Claude、ChatGPT、GitHub Copilot 等)能够与您的 Zotero 文献库进行交互。
主要特性
- 🗂️ 文件夹管理 - 创建、重命名、移动和删除 Zotero 文件夹(集合)
- 🏷️ 标签管理 - 为文献添加、删除和查询标签
- 📖 - 搜索条目、获取详情、管理文件夹关系
接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y [email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
claude mcp add io.github.combjellyshen-zotero-bridge -- npx -y zotero-bridge@1.0.3在終端機中執行。
{ "mcpServers": { "io.github.combjellyshen-zotero-bridge": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
ZoteroBridge 是一个模型上下文协议 (MCP) 服务器,可直接连接到 Zotero 的 SQLite 数据库 (zotero.sqlite),让 AI 助手(如 Claude、ChatGPT、GitHub Copilot 等)能够与您的 Zotero 文献库进行交互。
MCP Server for Zotero SQLite Database - collection, tagging, PDF reading and more.
🗑️ 回收站识别功能
deletedItems 表中的条目getItemDetails 新增 isDeleted 和 dateDeleted 字段findItemByDOI/ISBN/Identifier 自动跳过回收站中的条目isItemDeleted() 方法检查条目是否在回收站getDeletedItems() 方法获取回收站内容getDeletedItemsCount() 方法获取回收站条目数量🔧 修复
clientDateModified 字段clientDateModified 时间戳现在可以正常使用:
# 克隆仓库
git clone https://github.com/Combjellyshen/ZoteroBridge.git
cd ZoteroBridge
# 安装依赖
npm install
# 构建项目
npm run build
添加到 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/mcp.json:
{
"mcpServers": {
"zotero-bridge": {
"command": "npx",
"args": ["-y", "zotero-bridge"]
}
}
}
Ctrl+,)github.copilot.chat.mcpServers"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"]
}
}
}
管理 Zotero 文件夹(集合)的所有操作。
管理标签的所有操作。
按标题搜索 Zotero 条目。
通过 ID 或 Key 获取条目的详细信息。
管理条目的摘要和笔记。
PDF 文件的各种操作。
通过各种标识符查找文献,支持自动检测。
获取 PDF 标注(高亮、笔记等),支持按类型、颜色筛选或搜索。
在 Zotero 全文索引中搜索或获取附件的全文内容。
通过多种方式查找相关文献。
获取 Zotero 数据库信息(路径、存储位置、统计数据)。
执行原始 SQL 查询(仅支持 SELECT,只读)。
维护和清理 Zotero 库的工具。
# 搜索文献
搜索标题中包含"深度学习"的条目
# 获取详情
获取 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
zotero.sqlite--readonly 参数更安全library_maintenance 的 validate_attachments 检查文件是否存在🔧 重要修复 - 数据库兼容性
findItemByDOI/ISBN 现在始终返回最新修改的条目itemTags.type 字段 - 该字段为 NOT NULL,必须提供值note/attachment 的 itemTypeID,不再硬编码deletedItems 表中的已删除条目🚀 新功能
beginTransaction/commitTransaction/rollbackTransaction)mergeItems 现在使用事务保证数据一致性mergeItems 新增附件转移功能_duplicateWarning 警告信息🛡️ 安全性改进
library_maintenance 工具(重复检测、附件验证、孤立清理、条目合并)本项目采用 MIT 许可证。
欢迎提交 Issue 或 Pull Request!
MCP Server for Zotero SQLite Database - collection, tagging, PDF reading and more.
{ "mcpServers": { "io.github.combjellyshen-zotero-bridge": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Zotero Bridge 透過 stdio 在本機執行。
上次檢查時間:2026-11-09。 MCP Server for Zotero SQLite Database - collection, tagging, PDF reading and more.