Zotero MCP 指南

什么是 Zotero MCP？

自 BibGenie v0.4.0 版本起，我们引入了原生的 Zotero MCP (Model Context Protocol) 支持。这一功能旨在为用户提供更灵活的 Zotero AI 集成方式。

简单来说，MCP Server 就像一座桥梁，它允许您喜爱的外部 AI 工具（如 Claude、Cursor、VS Code 等）直接“读取”和“操作”您的 Zotero 文献库。

核心优势

• 开箱即用：BibGenie 的 MCP Server 是内置的。只要您安装了 BibGenie 插件，MCP 服务就会自动启动，无需额外安装 Python 或 Node.js 环境。
• 本地安全：所有数据交互直接在您的本地设备上进行，确保隐私安全。
• 高效流式传输：基于 Streamable HTTP 协议，响应速度快。

核心功能 (Tools)

目前，BibGenie MCP 提供了以下核心工具，专为科研场景优化：

1. Get Items in Collection (获取集合条目)
   • 获取 Zotero 中指定 Collection（收藏夹）下的全部 Item 列表。
   • 适用于：让 AI 快速了解某个特定研究方向下的所有文献。
2. Search Items (搜索条目)
   • 通过 关键字 快速检索 Zotero 文库。
   • 支持通过 Tag（标签）、Date（日期）等元数据进行精确筛选。
   • 分层设计：搜索仅返回简要信息，最大化节省 Token 并提升速度。
3. Get Item Details (获取详情)
   • 获取某个 Item 的所有元数据信息（如笔记 Notes、标签 Tags、摘要 Abstract、引用信息等）。
   • 注：此工具不返回 PDF 全文，而是通过提示词注入来引导模型在需要的时候自动调用 Get PDF Text 工具来获取全文
4. Get PDF Text (获取 PDF 全文)
   • 直接提取并通过 AI 读取 Zotero 中 PDF 附件的纯文本内容。
   • 模型会在需要的时候，自动使用此工具来获取 PDF 全文。

如何使用

BibGenie 提供的 MCP Server 类型为 Streamable HTTP。 默认服务地址为：http://127.0.0.1:23119/bibgenie/mcp

准备工作

在开始连接之前，请确保 Zotero 中安装了 BibGenie 插件，且版本在 v0.4.0 或以上。

您可以直接在浏览器中打开 http://127.0.0.1:23119/bibgenie/mcp 来测试 MCP Server 是否正常运行。如果看到类似如下信息，说明 zotero mcp 已正常工作：

{
  "name": "bibgenie-mcp-server",
  "version": "1.0.0",
  "protocolVersion": "2024-11-05",
  "capabilities": {
    "tools": {
    }
  },
  "status": "running"
}

连接 Cursor

Cursor 是目前体验最佳的 AI 代码编辑器，通过连接 MCP，它可以直接引用您的论文回答问题。

{
  "mcpServers": {
    "ZoteroBibGenie": {
      "url": "http://127.0.0.1:23119/bibgenie/mcp"
    }
  }
}

连接 Claude Desktop

对于 Claude Desktop，最新版本已支持通过图形界面管理 MCP。这使得将 Zotero 集成到您的Claude Desktop中变得前所未有的简单。

{
  "mcpServers":{
    "ZoteroBibGenie":{
      "command":"npx",
      "args":[
        "mcp-remote",
        "http://localhost:23119/bibgenie/mcp"
      ]
    }
  }
}

连接 Claude Code

如果您使用命令行工具 claude-code，可以使用以下命令快速添加：

claude mcp add ZoteroBibGenie --transport http http://127.0.0.1:23119/bibgenie/mcp

更多信息请参考 Claude Code MCP 文档。

连接 Cherry Studio

Cherry Studio 是一款强大的支持多模型管理的本地 AI 客户端，也完美支持 MCP 协议。

使用场景示例

连接成功后，您可以尝试以下 Prompts (提示词) 来体验 Zotero Copilot 的强大能力：

文献检索

深度阅读

知识库管理

常见问题 (FAQ)