Zotero MCP Server

Zotero MCP サーバー

Zotero と連携する Model Context Protocol（MCP）サーバーです。AI アプリケーションから Zotero ライブラリにアクセスして操作できます。

最新の MCP の考え方とベストプラクティスに沿って、公式の MCP Python SDK で構築されています。

機能

• Zotero ライブラリ内のアイテムを検索
• 引用と参考文献一覧を取得
• Zotero ライブラリに新しいアイテムを追加
• コレクションとアイテムにアクセス
• 個人ライブラリとグループライブラリの両方をサポート

インストール

1. リポジトリをクローンします：

   git clone https://github.com/your-username/zotero-mcp-server.git
   cd zotero-mcp-server
   

2. 仮想環境を作成します：

   python -m venv venv
   

3. 仮想環境を有効化します：

   • Linux/macOS の場合：

     source venv/bin/activate
     

   • Windows の場合：

     venv\Scripts\activate
     

4. 依存関係をインストールします：

   pip install -r requirements.txt
   

設定

1. 環境ファイルのサンプルをコピーします：

   cp .env.example .env
   

2. Zotero API の認証情報を .env ファイルに記入します：

   ZOTERO_API_KEY=your_api_key_here
   ZOTERO_USER_ID=your_numeric_user_id_here
   # ZOTERO_GROUP_ID=your_group_id_here  # Uncomment to use a group library
   

   ZOTERO_USER_ID（個人ライブラリの場合）または ZOTERO_GROUP_ID（グループライブラリの場合）のいずれかを設定する必要があります。

3. Zotero のユーザー ID の確認方法がわからない場合は、次を実行します：

   ./find_zotero_id.py
   

使い方

サーバーの起動

python src/server.py

サーバーが起動し、標準入出力で JSON-RPC リクエストを待ち受けます。

サーバーのテスト

./simple_test.py

サーバーが正しく動作していることを確認する一連のテストが実行されます。

AI アプリケーションとの連携

Zotero MCP サーバーは、Model Context Protocol をサポートする AI アプリケーションと連携できます。詳しい例については、USAGE_GUIDE.md ファイルを参照してください。

利用可能なリソース

• zotero://collections：Zotero ライブラリ内のコレクション一覧
• zotero://items/top：Zotero ライブラリ内の最上位アイテム
• zotero://items/recent：Zotero ライブラリに最近追加または変更されたアイテム
• zotero://collections/{collection_key}/items：特定の Zotero コレクション内のアイテム
• zotero://items/{item_key}：特定の Zotero アイテムの詳細
• zotero://items/{item_key}/citation/{style}：指定したスタイルでの特定の Zotero アイテムの引用

利用可能なツール

• search_items：Zotero ライブラリ内のアイテムを検索
• get_citation：特定のアイテムの引用を取得
• add_item：Zotero ライブラリに新しいアイテムを追加
• get_bibliography：複数のアイテムの参考文献一覧を取得
• create_collection：Zotero ライブラリに新しいコレクションを作成
• update_item：Zotero ライブラリ内の既存のアイテムを更新
• delete_item：Zotero ライブラリからアイテムを削除
• get_item_types：利用可能なすべての Zotero アイテムタイプの一覧を取得
• get_item_fields：特定のアイテムタイプで利用可能なフィールドを取得

ドキュメント

詳しくは、以下を参照してください：

• USAGE_GUIDE.md：包括的な使用ガイド
• test_client.py：対話型テストクライアント
• simple_test.py：簡単なテストスクリプト
• find_zotero_id.py：Zotero ID を確認するためのヘルパースクリプト

ライセンス

MIT

貢献

貢献を歓迎します！お気軽にプルリクエストをお送りください。