MCP
BibGenie のローカル MCP サーバーを使い、外部クライアントから Zotero ツールへアクセスできるようにします。
MCP は Model Context Protocol の略です。BibGenie はローカル MCP サーバーを起動でき、MCP 対応クライアントが Zotero 関連ツールにアクセスできるようになります。
ほとんどのユーザーは MCP を必要としません
BibGenie プラグイン内だけでチャットする場合、MCP を設定する必要はありません。MCP は主に上級ユーザー、外部クライアント、自動化ワークフロー向けです。
MCP でできること
外部クライアントは BibGenie の Zotero ツールを使って、次のことができます。
- Zotero アイテムを検索する
- セマンティック文献検索を実行する
- PDF 添付ファイルを読む
- スナップショットを読む
- Zotero ノートを読む
- タグとコレクションを一覧表示する
- Zotero ノートを作成する
- タグとコレクションを管理する
- メタデータを取得または編集する
Zotero MCP とは?
Zotero MCP は、BibGenie が Zotero ライブラリと外部 AI クライアントの間に作るローカルな橋渡しです。ファイルを書き出したりメタデータを手動でコピーしたりしなくても、MCP 対応クライアントはローカルプロトコルを通じて BibGenie に Zotero の文脈を問い合わせられます。
たとえば外部クライアントは、BibGenie の MCP ツールを通じてライブラリ検索、コレクション確認、PDF 添付ファイルの読み取り、Zotero ノートの作成を行えます。
主な利点
内蔵
BibGenie の MCP Server は Zotero プラグイン内で動作します。別の Python サービスや独自のローカルバックエンドは不要です。
ローカルが基本
MCP endpoint は Zotero のローカル HTTP サーバー上で動作します。外部クライアントはあなたのデバイス上で Zotero と通信します。
研究向け
ツールは Zotero のワークフロー、論文、PDF、コレクション、タグ、ノート、スナップショット、メタデータ向けに設計されています。
外部ワークフローに対応
MCP により Cursor、Claude Code、Claude Desktop、Cherry Studio などが、それぞれの画面のまま Zotero の文脈を使えます。
主な機能
| 機能 | 役立つ場面 |
|---|---|
| アイテム検索 | タイトル、著者、出版物、キーワード、トピックで論文を探す。 |
| セマンティック検索 | 完全一致キーワードだけでなく、意味にもとづいて関連論文を見つける。 |
| メタデータ取得 | 引用、整理、編集の前に Zotero アイテムの詳細メタデータを読む。 |
| PDF 読み取り | クライアントが論文本文を必要とするとき、Zotero PDF 添付ファイルのテキストを読む。 |
| PDF の視覚読み取り | 図、表、スキャンページなど視覚的な確認が必要な場合に PDF ページを画像としてレンダリングする。 |
| ノートとスナップショット | ライブラリ内の Zotero ノートと Web スナップショットを読む。 |
| ライブラリ整理 | コレクションとタグの一覧表示、コレクション作成、タグや所属コレクションの管理を行う。 |
| 制御された書き込み | 信頼できるクライアントが明示的な MCP tool call を通じてノート作成やメタデータ編集を行う。 |
プラグイン内チャットと MCP
| モード | 最適な用途 | 設定が必要 |
|---|---|---|
| BibGenie のプラグイン内チャット | ほとんどのユーザー | いいえ |
| ローカル MCP Server | Zotero を外部 AI クライアントに接続するユーザー | はい |
サーバータイプと URL
BibGenie の MCP Server は Streamable HTTP を使用します。Server URL は通常、次のような形式です。
http://127.0.0.1:23119/bibgenie/mcpZotero の HTTP サーバーがカスタムポートを使っている場合、ポートは異なることがあります。手入力ではなく、BibGenie 設定に表示される Server URL をコピーしてください。
ブラウザで URL を直接開いて MCP をテストしないでください
MCP クライアントは HTTP POST JSON-RPC リクエストで接続します。ブラウザのアドレスバーは 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 設定に別のポートが表示されている場合は、その 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/mcpBibGenie 設定に別のポートが表示されている場合は、その URL に置き換えてください。
Claude Desktop
Claude Desktop の一部のバージョンでは、ローカル HTTP endpoint より 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 ボタンで接続を確認します。
プロンプト例
- 「2023 年以降に発表された retrieval-augmented generation に関する Zotero 論文を探して。」
- 「この Zotero アイテムの PDF 添付ファイルを読んで、論文の主要な貢献を要約して。」
- 「Machine Learning コレクションのアイテムを一覧表示し、年のメタデータがないものを見つけて。」
セキュリティ上の推奨事項
- MCP Server URL は信頼できるクライアントにのみ共有してください。
- ノート作成、メタデータ編集、タグやコレクション管理など、Zotero ライブラリへ書き込むツールには注意してください。
- MCP を使っていないときはサーバーをオフにしてください。
- 外部クライアントが予期しない動作をする場合は、MCP サーバーを停止し、クライアント設定を確認してください。
BibGenieドキュメント