Zotero MCP Server

Zotero MCP サーバー

MCP クライアント（Anthropic Claude App、Goose、場合によっては vscode Cline など）がローカルの Zotero リポジトリと連携できるようにする、MCP（Model Context Protocol）サーバーです。このサーバーを使うと、Zotero ライブラリにプログラムからアクセスでき、論文の検索やノートの管理などができます。

注：API キーを設定せずに使いたい場合は、以下のSQLite データベースサーバーのオプションを参照してください。

セットアップ

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

pip install -e .

2. ルートディレクトリに .env ファイルを作成し、Zotero の認証情報を記述します：

ZOTERO_API_KEY=your_api_key_here
ZOTERO_USER_ID=your_user_id_here

Zotero の API キーとユーザー ID は、Zotero の設定ページで確認できます。

Anthropic Desktop App との連携

Anthropic Desktop app と連携するには、次の設定を ~/Library/Application Support/Claude/claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "zotero-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/swairshah/work/research/zotero-mcp",
        "run",
        "python",
        "-m",
        "zotero_mcp.server"
      ]
    }
  }
}

これによって次のようなエラーが発生する場合：

{"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"claude-ai","version":"0.1.0"}},"jsonrpc":"2.0","id":0}
  error: unexpected argument '--directory' found

以下の設定を使用してください。サーバーがすべての依存関係とともに実行できるよう、uv venv、source .venv/bin/activate、uv pip install ".[dev]" を実行してください。

{
   "mcpServers": {
      "zotero-mcp-server": {
        "command": "bash",
        "args": [
          "-c",
          "cd /Users/shahswai/personal/zotero-mcp-server && source .venv/bin/activate && python -m zotero_mcp.server"
        ]
      }
    }
  }

代替方法：SQLite データベースへの直接アクセス

Zotero API を完全に迂回して SQLite データベースを直接操作したい場合は、zotero_mcp/db_server.py を使用してください。この方法では、API の制限を受けずに Zotero のデータを完全に制御できます。SQLite は Zotero の実行中にデータベースをロックするため、この方法を使う前に Zotero を完全に終了する必要があります。

SQLite 版の Claude MCP 設定：

{
  "mcpServers": {
    "zotero-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/swair/work/code/zotero-mcp-server",
        "run",
        "python",
        "-m",
        "zotero_mcp.db_server"
      ]
    }
  }
}

使用例

このサーバーでは、次のことができます：

• タグで論文を検索する
• 論文の詳細と添付されたノートを取得する
• 論文にノートを追加する
• 論文の要約をリクエストする