Zotero MCP

Zotero MCP：您在克劳德的研究图书馆

Zotero MCP通过模型上下文协议 (MCP)将您的Zotero研究库与Claude及其他 AI 助手（ Cherry Studio 、 Cursor等）无缝连接。您可以讨论论文、获取摘要、分析引文、提取 PDF 注释等等！

✨ 特点

🔍 搜索你的图书馆

• 按标题、作者或内容查找论文、文章和书籍
• 使用多个条件执行复杂搜索
• 浏览收藏集、标签和最近添加的内容

📚 访问您的内容

• 检索任何项目的详细元数据
• 获取全文内容（如有）
• 访问附件、注释和子项目

📝 使用注释

• 直接提取和搜索 PDF 注释
• 访问 Zotero 的原生注释
• 创建和更新注释和注解

🌐 灵活的访问方式

• 离线访问的本地方法（无需 API 密钥）
• 用于云图书馆访问的 Web API
• 非常适合本地研究和远程协作

🚀 快速安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Zotero MCP：

手动安装

通过 uv 安装

通过 pip 安装

🖥️ 设置和使用

完整文档可在Zotero MCP 文档中找到。

要求

• Python 3.10+
• Zotero 7+（用于具有全文访问的本地 API）
• Claude Desktop 或兼容的 AI 助手

对于克劳德桌面

配置

安装后，可以执行以下操作之一：

1. 自动配置（推荐）：
   zotero-mcp setup
2. 手动配置：添加到您的claude_desktop_config.json ：
   { "mcpServers": { "zotero": { "command": "zotero-mcp", "env": { "ZOTERO_LOCAL": "true" } } } }

用法

1. 启动 Zotero 桌面（确保在首选项中启用了本地 API）
2. 启动 Claude Desktop
3. 通过 Claude Desktop 的工具界面访问 Zotero-MCP 工具

提示示例：

• “在我的图书馆中搜索有关机器学习的论文”
• “查找我最近添加的有关气候变化的文章”
• “总结我关于量子计算的论文的主要发现”
• “从我的神经网络论文中提取所有 PDF 注释”
• “在我的笔记和注释中搜索‘强化学习’”

对于 Cherry Studio

配置

前往“设置”->“MCP 服务器”->“编辑 MCP 配置”，添加以下内容：

然后点击“保存”。

Cherry Studio 还提供了常规设置和工具选择的可视化配置方法。

🔧 高级配置

使用 Web API 代替本地 API

通过 Web API 访问您的 Zotero 库（对于远程设置有用）：

环境变量

• ZOTERO_LOCAL=true ：使用本地 Zotero API（默认值：false）
• ZOTERO_API_KEY ：您的 Zotero API 密钥（用于 Web API）
• ZOTERO_LIBRARY_ID ：您的 Zotero 库 ID（用于 Web API）
• ZOTERO_LIBRARY_TYPE ：库的类型（用户或组，默认：用户）

命令行选项

📑 PDF 注释提取

Zotero MCP 包含高级 PDF 注释提取功能：

• 直接 PDF 处理：直接从 PDF 文件中提取注释，即使它们尚未被 Zotero 索引
• 增强搜索：搜索 PDF 注释和评论
• 图像注释支持：从 PDF 中提取图像注释
• 无缝集成：与 Zotero 的原生注释系统协同工作

为了获得最佳的注释提取效果，强烈建议安装 Zotero 的Better BibTeX 插件。注释相关的功能已通过此插件初步测试，并将在插件可用时提供增强功能。

第一次使用PDF注释功能时，必要的工具将自动下载。

📚 可用工具

搜索工具

• zotero_search_items ：搜索你的图书馆
• zotero_advanced_search ：执行复杂的搜索
• zotero_get_collections ：列出集合
• zotero_get_collection_items ：获取集合中的项目
• zotero_get_tags ：列出所有标签
• zotero_get_recent ：获取最近添加的项目

内容工具

• zotero_get_item_metadata ：获取详细元数据
• zotero_get_item_fulltext ：获取全文内容
• zotero_get_item_children ：获取附件和注释

注释和笔记工具

• zotero_get_annotations ：获取注释（包括直接 PDF 提取）
• zotero_get_notes ：从 Zotero 库中检索笔记
• zotero_search_notes ：在笔记和注释中搜索（包括 PDF 提取）
• zotero_create_note ：为项目创建新注释（测试版功能）

🔍 故障排除

• 未找到结果：确保 Zotero 正在运行并且本地 API 已启用
• 无法连接到库：如果使用 Web API，请检查您的 API 密钥和库 ID
• 全文不可用：请确保您使用 Zotero 7+ 进行本地全文访问

📄 许可证

麻省理工学院