Zotero MCP：在 Claude 中使用您的研究图书馆

<p align="center"> <a href="https://www.zotero.org/"> <img src="https://img.shields.io/badge/Zotero-CC2936?style=for-the-badge&logo=zotero&logoColor=white" alt="Zotero"> </a> <a href="https://www.anthropic.com/claude"> <img src="https://img.shields.io/badge/Claude-6849C3?style=for-the-badge&logo=anthropic&logoColor=white" alt="Claude"> </a> <a href="https://modelcontextprotocol.io/introduction"> <img src="https://img.shields.io/badge/MCP-0175C2?style=for-the-badge&logoColor=white" alt="MCP"> </a> </p>

Zotero MCP 通过 模型上下文协议 将您的 Zotero 研究图书馆与 Claude 和其他 AI 助手无缝连接。讨论论文、获取摘要、分析引用等等！

🚀 快速安装

通过 Smithery 安装

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

npx -y @smithery/cli install @54yyyu/zotero-mcp --client claude

手动安装

pip install git+https://github.com/54yyyu/zotero-mcp.git
zotero-mcp setup  # 自动配置 Claude Desktop

✨ 功能

搜索您的图书馆

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

访问您的内容

• 检索任何项目的详细元数据
• 获取全文内容（如果可用）
• 访问附件、笔记和子项目

🖥️ 设置和使用

对于 Claude Desktop

安装后，选择以下方式之一：

1. 自动配置（推荐）：

   zotero-mcp setup
   

2. 手动配置： 添加到您的 claude_desktop_config.json：

   {
     "mcpServers": {
       "zotero": {
         "command": "zotero-mcp",
         "env": {
           "ZOTERO_LOCAL": "true"
         }
       }
     }
   }
   

要求

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

在 Claude 中使用 Zotero

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

示例提示：

• "在我的图书馆中搜索关于机器学习的论文"
• "查找我最近添加的关于气候变化的文章"
• "总结我的量子计算论文中的主要发现"

🔧 高级配置

使用 Web API 而不是本地 API

要通过 Web API 访问您的 Zotero 图书馆（适用于远程设置）：

zotero-mcp setup --no-local --api-key YOUR_API_KEY --library-id YOUR_LIBRARY_ID

环境变量

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

命令行选项

# 直接运行服务器
zotero-mcp serve

# 指定传输方法
zotero-mcp serve --transport stdio|sse

# 获取有关设置选项的帮助
zotero-mcp setup --help

📚 可用工具

搜索工具

• 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 正在运行并且本地 API 已启用
• 无法连接到图书馆：如果使用 Web API，请检查您的 API 密钥和图书馆 ID
• 全文不可用：确保您使用的是 Zotero 7+ 以进行本地全文访问

📄 许可证

MIT