BibGenie 文档MCP 设置
开启、关闭、复制和测试 BibGenie 的本地 MCP Server。
MCP Settings 用于管理 BibGenie 的本地 MCP Server。开启后，外部 MCP 客户端可以通过 Server URL 访问 BibGenie 暴露的 Zotero 工具。
设置项
Enable MCP Server
开启或关闭本地 MCP Server。
Server URL
外部客户端连接 BibGenie MCP Server 时使用的地址。通常类似 http://127.0.0.1:23119/bibgenie/mcp，但如果 Zotero 使用自定义 HTTP Server 端口，端口可能不同。
Copy
将 Server URL 复制到剪贴板。
Test Connection
通过 HTTP POST JSON-RPC 发送 MCP initialize 请求，验证端点是否可达。
浏览器测试可能会误导
直接在浏览器中打开 Server URL 不等于 MCP 连接。MCP 客户端发送的是 POST JSON-RPC 请求，而浏览器地址栏发送的是 GET 请求。请使用 Test Connection 做真实检测。
状态说明
| 状态 | 含义 |
|---|---|
| Server is off | MCP Server 未开启 |
| Starting | 正在启动 |
| Server running | 已启动，可供外部客户端连接 |
| Testing connection | 正在测试连接 |
| Connection verified | 测试成功 |
| Connection failed | 测试失败，需要检查 URL 或运行状态 |
连接失败时检查
- 确认 Zotero 正在运行。
- 确认 BibGenie 插件已在 Zotero 中启用。
- 确认 Enable MCP Server 已开启。
- 复制设置页显示的 Server URL，不要默认认为端口一定是
23119。 - 如果刚开启 Server 或刚更新插件，可以重启 Zotero 后再试。
开启 MCP
进入 BibGenie Preferences。
找到 MCP Server 区域。
打开 Enable MCP Server。
等待 Server URL 出现。
点击 Copy，把 URL 粘贴到外部 MCP 客户端。
点击 Test Connection 验证可用性。
关闭 MCP
不使用外部客户端时，可以关闭 Enable MCP Server。关闭后，外部客户端将无法继续访问 BibGenie 的 MCP 工具。
只连接可信客户端
MCP 工具可能读取或修改 Zotero library。请只把 Server URL 提供给你信任的客户端。