Zotero MCP Server

🚀 Zotero MCP サーバー

Model Context Protocol (MCP) サーバーで、Zotero に統合され、AI アプリケーションが Zotero ライブラリにアクセスし操作できるようにします。

✨ 主な機能

• 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. .env ファイルを自分の Zotero API 資格情報で編集します：

   ZOTERO_API_KEY=your_api_key_here
   ZOTERO_USER_ID=your_numeric_user_id_here
   # ZOTERO_GROUP_ID=your_group_id_here  # グループライブラリを使用する場合はコメントを外す
   

   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://items/recent: 最近追加または変更された項目
• zotero://collections/{collection_key}/items: 特定のコレクション内の項目
• zotero://items/{item_key}: 特定の Zotero 項目の詳細情報
• zotero://items/{item_key}/citation/{style}: 特定の項目の特定の形式の引用

📚 ドキュメント - 利用可能なツール

• search_items: Zotero ライブラリ内で項目を検索する
• get_citation: 特定の項目の引用を取得する
• add_item: 新しい項目を Zotero ライブラリに追加する
• get_bibliography: 複数の項目の参考文献を取得する

📚 ドキュメント - 詳細情報

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

• USAGE_GUIDE.md: 詳細な使用ガイド
• test_client.py: 対話型テストクライアント
• simple_test.py: 簡単なテストスクリプト
• find_zotero_id.py: Zotero ID を見つけるのに役立つスクリプト

📄 ライセンス

MIT

🤝 貢献

貢献を歓迎します！自由に Pull Request を提出してください。