MCP Zotero

🚀 MCP Zotero サーバー

Zotero との統合に使用される Model Context Protocol サーバーで、Claude があなたの Zotero ライブラリとやり取りできるようにします。

🚀 クイックスタート

📦 インストール

1. Zotero の認証情報を取得する

# まず、https://www.zotero.org/settings/keys で API キーを作成します
# 次に、それを使ってユーザー 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. 認証情報を検証する

# 認証情報が有効かどうかをテストします：
curl -H "Zotero-API-Key: $ZOTERO_API_KEY" \
     "https://api.zotero.org/users/$ZOTERO_USER_ID/collections"

コレクションのリストがレスポンスとして表示されるはずです。

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

# グローバルにインストールする（推奨）
npm install -g mcp-zotero
mcp-zotero

# または 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