MCP

MCP は Model Context Protocol の略です。BibGenie はローカル MCP サーバーを起動でき、MCP 対応クライアントが Zotero 関連ツールにアクセスできるようになります。

MCP でできること

外部クライアントは BibGenie の Zotero ツールを使って、次のことができます。

• Zotero アイテムを検索する
• セマンティック文献検索を実行する
• PDF 添付ファイルを読む
• スナップショットを読む
• Zotero ノートを読む
• タグとコレクションを一覧表示する
• Zotero ノートを作成する
• タグとコレクションを管理する
• メタデータを取得または編集する

Zotero MCP とは？

Zotero MCP は、BibGenie が Zotero ライブラリと外部 AI クライアントの間に作るローカルな橋渡しです。ファイルを書き出したりメタデータを手動でコピーしたりしなくても、MCP 対応クライアントはローカルプロトコルを通じて BibGenie に Zotero の文脈を問い合わせられます。

たとえば外部クライアントは、BibGenie の MCP ツールを通じてライブラリ検索、コレクション確認、PDF 添付ファイルの読み取り、Zotero ノートの作成を行えます。

主な利点

主な機能

プラグイン内チャットと MCP

サーバータイプと URL

BibGenie の MCP Server は Streamable HTTP を使用します。Server URL は通常、次のような形式です。

http://127.0.0.1:23119/bibgenie/mcp

Zotero の HTTP サーバーがカスタムポートを使っている場合、ポートは異なることがあります。手入力ではなく、BibGenie 設定に表示される Server URL をコピーしてください。

MCP Server を有効化する

外部クライアントを接続する

Streamable HTTP MCP をサポートするクライアントで、BibGenie 設定に表示される Server URL を使います。

Cursor

Cursor は BibGenie の Streamable HTTP endpoint に直接接続できます。

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

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 の一部のバージョンでは、ローカル HTTP endpoint より stdio MCP server の方が安定して接続できます。その場合は mcp-remote を Claude Desktop と BibGenie のローカル HTTP Server の橋渡しとして使います。

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

Cherry Studio

Cherry Studio は Streamable HTTP MCP に直接対応しています。

プロンプト例

• 「2023 年以降に発表された retrieval-augmented generation に関する Zotero 論文を探して。」
• 「この Zotero アイテムの PDF 添付ファイルを読んで、論文の主要な貢献を要約して。」
• 「Machine Learning コレクションのアイテムを一覧表示し、年のメタデータがないものを見つけて。」

セキュリティ上の推奨事項

• MCP Server URL は信頼できるクライアントにのみ共有してください。
• ノート作成、メタデータ編集、タグやコレクション管理など、Zotero ライブラリへ書き込むツールには注意してください。
• MCP を使っていないときはサーバーをオフにしてください。
• 外部クライアントが予期しない動作をする場合は、MCP サーバーを停止し、クライアント設定を確認してください。

FAQ