Zotero MCP

🚀 ZoteroのModel Context Protocol (MCP) サーバー

このプロジェクトはPythonベースのサーバーで、Model Context Protocol (MCP) と Zotero の統合を実現しています。これにより、AIアシスタントを通じてZoteroの文献ライブラリにアクセスすることができます。このプロジェクトの目的は、MCPクライアント と通信するための、できるだけ実用的な一連の機能を実装することです。

✨ 主な機能

このMCPサーバーは以下のツールを提供します：

• zotero_search_items：テキストクエリを使用して、あなたのZotero文献ライブラリ内で項目を検索します。
• zotero_item_metadata：特定のZotero項目の詳細なメタデータ情報を取得します。
• zotero_item_fulltext：特定のZotero項目の全文内容（例：PDFファイル）を取得します。

これらのツールは、任意のMCPクライアントまたは MCP Inspector を通じて発見およびアクセスすることができます。

各ツールは、関連するZotero項目の情報を含む形式のテキストを返します。AIアシスタント（例：Claude）は、これらを順番に使用して、まず項目を検索し、その後メタデータまたは全文内容を取得することができます。

📦 インストール

このサーバーは、ZoteroのローカルAPIまたはリモートWeb APIと通信することができます。以下は2つのインストール方法です：

方法1：Dockerコンテナを使用する

mcp.json ファイルに以下の設定を追加し、プレースホルダーをあなたの実際のAPIキーとライブラリIDに置き換えてください：

{
  "mcpServers": {
    "zotero": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "ZOTERO_API_KEY=PLACEHOLDER", // あなたのAPIキーに置き換える
        "-e", "ZOTERO_LIBRARY_ID=PLACEHOLDER", // あなたのライブラリIDに置き換える
        "ghcr.io/kujenga/zotero-mcp:main"
      ]
    }
  }
}

方法2：ローカルインストール

1. このリポジトリをクローンします。
2. uv を使用して依存関係をインストールし、以下のコマンドを実行します：

   uv sync
   

3. プロジェクトのルートディレクトリに .env ファイルを作成し、以下の環境変数を含めます：

# ローカルAPIを使用する場合
ZOTERO_API=local

# またはリモートWeb APIを使用する場合
ZOTERO_API_KEY=your_api_key_here
ZOTERO_LIBRARY_ID=your_library_id_here

🔧 開発情報

開発またはコードの貢献を行うには、以下の手順に従ってください：

1. このリポジトリをクローンします。
2. uv を使用して依存関係をインストールし、以下のコマンドを実行します：

   uv sync
   

3. プロジェクトのルートディレクトリに .env ファイルを作成し、必要な環境変数を含めます。

MCP Inspector を起動してローカル開発を行います：

npx @modelcontextprotocol/inspector uv run zotero-mcp

Claude Desktopとの統合をテストするには、あなたのClaude設定に以下の内容を追加し、/path/to を実際のパスに置き換えてください：

{
  "mcpServers": {
    "zotero": {
      "command": "/path/to/zotero-mcp/.venv/bin/zotero-mcp",
      "env": {
        // 必要な環境変数設定を追加する
      }
    }
  }
}

テストの実行

テストスイートを実行するには、以下のコマンドを実行します：

uv run pytest

Docker開発

以下のコマンドを使用してコンテナイメージをビルドします：

docker build . -t zotero-mcp:local

Inspectorを通じてコンテナをテストするには、以下のコマンドを実行します：

npx @modelcontextprotocol/inspector \
    -e ZOTERO_API_KEY=$ZOTERO_API_KEY \
    -e ZOTERO_LIBRARY_ID=$ZOTERO_LIBRARY_ID \
    docker run --rm -i \
        --env ZOTERO_API_KEY \
        --env ZOTERO_LIBRARY_ID \
        zotero-mcp:local

📚 ドキュメント

• https://modelcontextprotocol.io/tutorials/building-mcp-with-llms
• https://github.com/modelcontextprotocol/python-sdk
• https://pyzotero.readthedocs.io/en/latest/
• https://www.zotero.org/support/dev/web_api/v3/start