MCP ゾテロ

Claude が Zotero ライブラリと対話できるようにする、Zotero 統合用のモデル コンテキスト プロトコル サーバー。

設定

1. Zotero の認証情報を取得します:

   # First, create an API key at https://www.zotero.org/settings/keys
   # Then use it to get your user ID:
   curl -H "Zotero-API-Key: YOUR_API_KEY" https://api.zotero.org/keys/current

   応答は次のようになります。

   {
     "userID": 123456,
     "username": "your_username",
     "access": {
       "user": {
         "library": true,
         "files": true,
         "notes": true,
         "write": true
       }
     }
   }

   必要なのはuserID値です。

2. 環境変数を設定します。

   export ZOTERO_API_KEY="your-api-key"
   export ZOTERO_USER_ID="user-id-from-curl"

3. 資格情報を確認してください:

   # Test that your credentials work:
   curl -H "Zotero-API-Key: $ZOTERO_API_KEY" \
        "https://api.zotero.org/users/$ZOTERO_USER_ID/collections"

   応答にコレクション リストが表示されます。

4. インストールして実行:

   # Install globally (recommended)
   npm install -g mcp-zotero
   mcp-zotero
   
   # Or run directly with npx
   npx mcp-zotero

Related MCP server: Zotero MCP Server

Claude Desktopとの統合

このサーバーを Claude Desktop で使用するには、Claude Desktop の構成に以下を追加します。

{
  "mcpServers": {
    "zotero": {
      "command": "mcp-zotero",
      "env": {
        "ZOTERO_API_KEY": YOUR_API_KEY,
        "ZOTERO_USER_ID": YOUR_USER_ID
      }
    }
  }
}

利用可能なツール

• get_collections : ライブラリ内のすべてのコレクションを一覧表示する

• get_collection_items : 特定のコレクション内のアイテムを取得する

• get_item_details : 論文の詳細情報を取得する

• search_library : ライブラリ全体を検索

• get_recent : 最近追加された論文を取得する

トラブルシューティング

問題が発生した場合:

1. 環境変数が設定されていることを確認します。

   echo $ZOTERO_API_KEY
   echo $ZOTERO_USER_ID

2. インストールを確認します:

   npm list -g mcp-zotero

3. 再インストールしてみてください:

   npm uninstall -g mcp-zotero
   npm install -g mcp-zotero