ゾテロ MCP

Zotero MCP: クロードにあるあなたの研究図書館

Zotero MCPは、モデルコンテキストプロトコルを介して、 ZoteroリサーチライブラリをClaudeやその他のAIアシスタント（ Cherry Studio 、 Cursorなど）とシームレスに接続します。論文の議論、要約の取得、引用の分析、PDF注釈の抽出など、様々な機能をご利用いただけます。

✨ 特徴

🔍 ライブラリを検索

論文、記事、書籍をタイトル、著者、内容で検索
複数の条件で複雑な検索を実行する
コレクション、タグ、最近追加されたものを閲覧する

📚 コンテンツにアクセスする

任意のアイテムの詳細なメタデータを取得する
全文コンテンツを取得する（利用可能な場合）
添付ファイル、メモ、子アイテムにアクセスする

📝 注釈の操作

PDF注釈を直接抽出して検索
Zoteroのネイティブ注釈にアクセスする
メモや注釈を作成および更新する

🌐 柔軟なアクセス方法

オフラインアクセス用のローカルメソッド (API キーは不要)
クラウドライブラリアクセス用のWeb API
現地調査とリモートコラボレーションの両方に最適

🚀 クイックインストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Zotero MCP を自動的にインストールするには:

npx -y @smithery/cli install @54yyyu/zotero-mcp --client claude

手動インストール

UV経由でインストール

uv tool install "git+https://github.com/54yyyu/zotero-mcp.git"
zotero-mcp setup  # Auto-configure for Claude Desktop

pip経由でインストール

pip install git+https://github.com/54yyyu/zotero-mcp.git
zotero-mcp setup  # Auto-configure for Claude Desktop

🖥️ セットアップと使用方法

完全なドキュメントはZotero MCP docsで参照できます。

要件

Python 3.10以上
Zotero 7+（フルテキストアクセス可能なローカルAPI用）
Claudeデスクトップまたは互換性のあるAIアシスタント

クロードデスクトップ向け

構成

インストール後、次のいずれかを実行します。

自動構成（推奨）:
zotero-mcp setup
手動設定: claude_desktop_config.jsonに追加します:
{ "mcpServers": { "zotero": { "command": "zotero-mcp", "env": { "ZOTERO_LOCAL": "true" } } } }

使用法

Zoteroデスクトップを起動します（設定でローカルAPIが有効になっていることを確認してください）
Claudeデスクトップを起動
Claude DesktopのツールインターフェースからZotero-MCPツールにアクセスします。

プロンプトの例:

「機械学習に関する論文をライブラリで検索」
「気候変動について最近追加した記事を見つける」
「量子コンピューティングに関する私の論文の主要な調査結果を要約してください」
「ニューラルネットワークに関する論文からすべてのPDF注釈を抽出する」
「強化学習」に関する言及を私のメモや注釈で検索してください

チェリースタジオ向け

構成

[設定] -> [MCP サーバー] -> [MCP 構成の編集] に移動し、以下を追加します。

{
  "mcpServers": {
    "zotero": {
      "name": "zotero",
      "type": "stdio",
      "isActive": true,
      "command": "zotero-mcp",
      "args": [],
      "env": {
        "ZOTERO_LOCAL": "true"
      }
    }
  }
}

次に「保存」をクリックします。

Cherry Studio は、一般的な設定とツールの選択のための視覚的な構成方法も提供します。

🔧 詳細設定

ローカル API の代わりに Web API を使用する

Web API 経由で Zotero ライブラリにアクセスするには (リモート設定に便利です):

zotero-mcp setup --no-local --api-key YOUR_API_KEY --library-id YOUR_LIBRARY_ID

環境変数

ZOTERO_LOCAL=true : ローカルの Zotero API を使用する (デフォルト: false)
ZOTERO_API_KEY : Zotero API キー (Web API 用)
ZOTERO_LIBRARY_ID : Zotero ライブラリ ID (Web API 用)
ZOTERO_LIBRARY_TYPE : ライブラリの種類（ユーザーまたはグループ、デフォルト: ユーザー）

コマンドラインオプション

# Run the server directly
zotero-mcp serve

# Specify transport method
zotero-mcp serve --transport stdio|sse

# Get help on setup options
zotero-mcp setup --help

📑 PDF注釈抽出

Zotero MCP には、高度な PDF 注釈抽出機能が含まれています。

直接PDF処理:Zoteroでインデックス付けされていない場合でも、PDFファイルから直接注釈を抽出します。
強化された検索: PDF の注釈やコメントを検索
画像注釈サポート: PDFから画像注釈を抽出
シームレスな統合: Zotero のネイティブ注釈システムと連携して動作します

最適な注釈抽出のために、Zotero用のBetter BibTeXプラグインのインストールを強くお勧めします。注釈関連の機能は主にこのプラグインでテストされており、利用可能な場合には機能が強化されます。

PDF 注釈機能を初めて使用する場合、必要なツールが自動的にダウンロードされます。

📚 利用可能なツール

検索ツール

zotero_search_items : ライブラリを検索
zotero_advanced_search : 複雑な検索を実行する
zotero_get_collections : コレクションの一覧を取得する
zotero_get_collection_items : コレクション内のアイテムを取得する
zotero_get_tags : すべてのタグを一覧表示する
zotero_get_recent : 最近追加されたアイテムを取得する

コンテンツツール

zotero_get_item_metadata : 詳細なメタデータを取得する
zotero_get_item_fulltext : 全文コンテンツを取得する
zotero_get_item_children : 添付ファイルとメモを取得する

注釈とメモツール

zotero_get_annotations : 注釈を取得する（直接 PDF 抽出を含む）
zotero_get_notes : Zotero ライブラリからノートを取得する
zotero_search_notes : メモと注釈（PDF 抽出を含む）を検索
zotero_create_note : アイテムに新しいメモを作成する (ベータ機能)

🔍 トラブルシューティング

結果が見つかりません: Zotero が実行中で、ローカル API が有効になっていることを確認してください
ライブラリに接続できません: Web API を使用している場合は、API キーとライブラリ ID を確認してください
全文は利用できません: ローカルの全文アクセスには Zotero 7 以降を使用していることを確認してください

📄 ライセンス

マサチューセッツ工科大学

Zotero MCP

Integrations