Zotero 用モデルコンテキストプロトコルサーバー

このプロジェクトは、 Zotero用のモデルコンテキストプロトコル（MCP）を実装したPythonサーバーです。これにより、AIアシスタント内でZoteroライブラリにアクセスできるようになります。MCPクライアントで使用するために、Zoteroとの小規模ながらも最大限の利便性を備えたインタラクション群を実装することを目的としています。

特徴

この MCP サーバーは次のツールを提供します。

• zotero_search_items : テキストクエリを使用して Zotero ライブラリ内のアイテムを検索します
• zotero_item_metadata : 特定の Zotero アイテムに関する詳細なメタデータ情報を取得します
• zotero_item_fulltext : 特定の Zotero アイテム（PDF コンテンツなど）の全文を取得します。

これらは、任意の MCP クライアントまたはMCP Inspectorを通じて検出およびアクセスできます。

各ツールは Zotero アイテムからの関連情報を含むフォーマットされたテキストを返します。Claude などの AI アシスタントはそれらを順番に使用してアイテムを検索し、そのメタデータまたはテキスト コンテンツを取得できます。

インストール

Claude Desktop でこれを使用するには、 mcpServers構成に以下を追加します。

ZOTERO_LOCAL設定は、プラグインをローカル Zotero APIにポイントし、クライアントと同じマシンで実行されている Zotero 7 (またはベータ バージョン、下記の注記を参照) を必要とします。

Zotero Web API を使用するには、API キーを作成し、Zotero アカウント設定でライブラリ ID (通常はユーザー ID) を見つける必要があります ( https://www.zotero.org/settings/keys) 。

次の環境変数は構成オプションを提供します。

• ZOTERO_LOCAL=true : ローカルの Zotero API を使用する (デフォルト: false、下記の注記を参照)
• ZOTERO_API_KEY : Zotero API キー (ローカル API では必要ありません)
• ZOTERO_LIBRARY_ID : Zotero ライブラリ ID (ユーザー ライブラリの場合はユーザー ID。ローカル API では必要ありません)
• ZOTERO_LIBRARY_TYPE : ライブラリの種類（ユーザーまたはグループ、デフォルト: ユーザー）

[!重要] フルテキストAPIをローカルで利用するには、Zoteroの次期リリースが必要です。当面は、この機能を使用するにはZoteroベータビルドをインストールする必要があります（2025年3月7日時点）。詳しくはhttps://github.com/zotero/zotero/pull/5004をご覧ください。

発達

1. このリポジトリをクローンする
2. uv syncを実行して、 uvで依存関係をインストールします。
3. 上記の環境変数を含む.envファイルをプロジェクトルートに作成します。

ローカル開発用にMCP Inspectorを起動します。

テストの実行

テスト スイートを実行するには:

関連ドキュメント

• https://modelcontextprotocol.io/tutorials/building-mcp-with-llms
• https://github.com/modelcontextprotocol/python-sdk
• https://pyzotero.readthedocs.io/en/latest/
• https://www.zotero.org/support/dev/web\_api/v3/start