BibGenie 文档MCP
使用 BibGenie 的本地 MCP Server，让外部客户端访问 Zotero 工具。
MCP 是 Model Context Protocol。BibGenie 可以启动一个本地 MCP Server，让支持 MCP 的外部客户端访问 Zotero 相关工具。
普通聊天不需要理解 MCP
如果你只在 BibGenie 插件内聊天，不需要手动配置 MCP。MCP 主要面向高级用户、外部客户端和自动化工作流。
MCP 可以做什么？
通过 BibGenie 暴露的 Zotero 工具，外部客户端可以完成这些任务：
- 搜索 Zotero items
- 基于语义检索文献
- 读取 PDF attachment
- 读取 snapshot
- 读取 Zotero note
- 列出 tags 和 collections
- 创建 Zotero note
- 管理 tags 和 collections
- 获取或编辑 metadata
什么是 Zotero MCP？
Zotero MCP 是 BibGenie 在你的 Zotero library 和外部 AI 客户端之间建立的本地桥梁。你不需要导出文件，也不需要手动复制 metadata，支持 MCP 的外部客户端可以通过本地协议向 BibGenie 请求 Zotero 上下文。
例如，外部客户端可以通过 BibGenie 的 MCP tools 搜索你的 library、查看 collections、读取 PDF attachment，或创建 Zotero note。
核心优势
内置能力
BibGenie 的 MCP Server 运行在 Zotero 插件内部，不需要额外安装 Python 服务或自定义本地后端。
默认本地运行
MCP endpoint 运行在 Zotero 的本地 HTTP Server 上。外部客户端是在你的设备上和 Zotero 通信。
面向科研工作流
MCP tools 围绕 Zotero 场景设计，包括 papers、PDFs、collections、tags、notes、snapshots 和 metadata。
适合外部工作流
MCP 让 Cursor、Claude Code、Claude Desktop、Cherry Studio 等工具可以在自己的界面里使用 Zotero 上下文。
核心功能
| 功能 | 适合做什么 |
|---|---|
| Item search | 按 title、author、publication、keyword 或 topic 查找论文。 |
| Semantic search | 按语义发现相关论文，而不是只做关键词匹配。 |
| Metadata access | 在引用、整理或编辑前读取完整 Zotero item metadata。 |
| PDF reading | 当外部客户端需要论文内容时，读取 Zotero PDF attachment 的文本。 |
| Visual PDF reading | 当页面包含图表、版面或扫描内容时，将 PDF 页面渲染为图片供视觉检查。 |
| Notes and snapshots | 读取 Zotero notes 和 web snapshots。 |
| Library organization | 列出 collections 和 tags，创建 collections，管理 tags 或 collection membership。 |
| Controlled writing | 可信客户端可以通过明确的 MCP tool call 创建 notes 或编辑 metadata。 |
插件内聊天和 MCP 的区别
| 使用方式 | 适合用户 | 是否需要配置 |
|---|---|---|
| BibGenie 插件内聊天 | 大多数用户 | 不需要 |
| 本地 MCP Server | 想把 Zotero 连接到外部 AI 客户端的用户 | 需要在设置中开启 |
Server 类型和 URL
BibGenie 的 MCP Server 使用 Streamable HTTP。Server URL 通常类似：
http://127.0.0.1:23119/bibgenie/mcp如果你的 Zotero HTTP Server 使用了自定义端口，端口可能不是 23119。请优先复制 BibGenie 设置页中显示的 Server URL，不要手动猜地址。
不要用浏览器直接打开 URL 来判断 MCP 是否可用
MCP 客户端使用 HTTP POST JSON-RPC 请求连接。浏览器地址栏直接打开 Server URL 发出的是 GET 请求，不能可靠判断 MCP 是否可用。请使用 BibGenie 设置里的 Test Connection，或用真正的 MCP 客户端测试。
如何启用 MCP Server
打开 BibGenie 设置页面。
找到 MCP Server 区域。
打开 Enable MCP Server。
复制显示出来的 Server URL。
在外部 MCP 客户端中填写该 URL。
点击 Test Connection 验证连接是否可用。
连接外部客户端
在支持 Streamable HTTP MCP 的客户端中，填写 BibGenie 设置页显示的 Server URL。
Cursor
Cursor 可以直接连接 BibGenie 的 Streamable HTTP endpoint。
打开 Cursor Settings，进入 Tools & MCP。
点击 + New MCP Server。
粘贴以下配置：
{
"mcpServers": {
"ZoteroBibGenie": {
"url": "http://127.0.0.1:23119/bibgenie/mcp"
}
}
}如果 BibGenie 设置页显示的端口不是 23119，请替换为实际 URL。
保存配置。Cursor 显示 MCP server 已连接后，就可以在 Cursor chat 中使用 Zotero 上下文。
Claude Code
Claude Code 可以直接添加 HTTP MCP Server：
claude mcp add ZoteroBibGenie --transport http http://127.0.0.1:23119/bibgenie/mcp如果 BibGenie 设置页显示的端口不同，请替换为实际 URL。
Claude Desktop
有些 Claude Desktop 版本连接 stdio MCP Server 更稳定。此时可以用 mcp-remote 作为桥接，把 Claude Desktop 连接到 BibGenie 的本地 HTTP Server。
如果系统中不能使用 node 和 npx，先安装 Node.js。
打开 Claude Desktop。
打开 Settings，进入 Developer 区域。
点击 Edit Config，打开 claude_desktop_config.json。
添加以下配置：
{
"mcpServers": {
"ZoteroBibGenie": {
"command": "npx",
"args": ["mcp-remote", "http://127.0.0.1:23119/bibgenie/mcp"]
}
}
}如果 BibGenie 设置页显示的端口不同，请替换配置里的 URL。
保存文件并重启 Claude Desktop。
Cherry Studio
Cherry Studio 可以直接连接 Streamable HTTP MCP。
打开 Cherry Studio Settings，切换到 MCP 标签。
点击 Add，选择 Quick Create。
填写：
- Name:
ZoteroBibGenie - Type:
Streamable HTTP - URL: 从 BibGenie 设置页复制的 Server URL
可选：展开 Advanced Settings，填写：
- Provider URL:
https://www.bibgenie.com/ - Logo URL:
https://www.bibgenie.com/favicon.png
点击 Save，开启该服务，并使用 Cherry Studio 的 verify 按钮测试连接。
示例 Prompt
- “帮我找 Zotero 中 2023 年之后关于 RAG 的论文。”
- “读取这个 Zotero item 的 PDF attachment，并总结论文核心贡献。”
- “列出 Machine Learning collection 里的文献，并检查哪些条目缺少年份 metadata。”
安全建议
- 只把 MCP Server URL 提供给可信客户端。
- 涉及写入 Zotero library 的工具，例如创建 note、编辑 metadata、管理 tags/collections，应谨慎授权。
- 不使用 MCP 时可以关闭 Server。
- 如果外部客户端行为异常，先停止 MCP Server，再检查客户端配置。