MCP Zotero

MCP Zotero

Claude が Zotero ライブラリを操作できるようにする、Zotero 連携用の Model Context Protocol サーバーです。

セットアップ

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
   

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