Zotero MCP Server

🚀 Zotero MCP サーバー

このサーバーは MCP（モデルコンテキストプロトコル）を使用し、MCP クライアント（例えば Anthropic の Claude アプリ、Goose、おそらく vscode Cline など）とローカルの Zotero 文献ライブラリを接続します。これにより、Zotero ライブラリにプログラムでアクセスし、論文の検索やノートの管理などが可能になります。

🚀 クイックスタート

このサーバーを使用することで、Zotero 文献ライブラリと MCP クライアントを接続し、様々な操作を行うことができます。

✨ 主な機能

• プログラムで Zotero ライブラリにアクセス可能
• 論文の検索やノートの管理などの操作が可能
• タグで論文を検索できる
• 論文の詳細情報や付属のノートを取得できる
• 論文にノートを追加できる
• 論文の要約をリクエストできる

📦 インストール

1. 依存関係のインストール

pip install -e .

2. .env ファイルの作成

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

ZOTERO_API_KEY=your_api_key_here
ZOTERO_USER_ID=your_user_id_here

Zotero API キーとユーザー ID は Zotero の設定ページ から取得できます。

💻 使用例

基本的な使用法

Anthropic Desktop アプリとの統合

Anthropic Desktop アプリで統合するには、~/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}
  エラー: 予期しないパラメータ '--directory' が見つかりました

以下の設定を使用し、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"
        ]
      }
    }
  }

高度な使用法

このサーバーを使用すると、以下の操作が可能です。

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