BibGenieBibGenie 文件

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 offMCP 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 提供給你信任的客戶端。

On this page