Zotero MCP：研究ライブラリを MCP クライアントへ接続する Python サーバー

MCP 名 io.github.54yyyu/zotero-mcp と README 概要

54yyyu/zotero-mcp は MCP 名 io.github.54yyyu/zotero-mcp を README 先頭に記載する Python プロジェクトです。Zotero 研究ライブラリを ChatGPT、Claude、Cherry Studio、Chorus、Cursor 等 MCP 対応 AI アシスタントへ接続し、論文レビュー、要約、引用分析、PDF 注釈抽出等を README が挙げています。言語 Python、MIT ライセンス、homepage stevenyuyy.com/zotero-mcp、素材時点スター約 4828、open issue 55、default branch main です。PyPI パッケージ名 zotero-mcp-server です。

MCP ツール数が多いほど固定コンテキストコストが増えるため、ZOTERO_MCP_TOOLSETS で必要集合だけ有効化するのが README 推奨の節約策です。 一次資料に無い挙動は試験環境でのみ確認し、本番反映は release タグと公式 docs の差分を記録したうえで行ってください。 第1追記として、54yyyu-zotero-mcp-deep-analysis の README 記載範囲を超えない確認項目を残します。compose 例・env 名・port 番号は素材どおり再読し、自分の OS/arch に合う release 資産だけを選んでください。 第7追記として、54yyyu-zotero-mcp-deep-analysis の README 記載範囲を超えない確認項目を残します。compose 例・env 名・port 番号は素材どおり再読し、自分の OS/arch に合う release 資産だけを選んでください。

uv・pip・pipx インストールと zotero-mcp setup

Quick Install は uv 推奨：`uv tool install zotero-mcp-server` の後 `zotero-mcp setup` で Claude Desktop 等を自動設定します。pip と pipx も同手順で文書化されています。基本 install は search、metadata、annotations、write 操作を含み ML 依存なしと README は述べます。更新は `zotero-mcp update --check-only` と `zotero-mcp update` で設定保持更新です。community 製 Zotero MCP Setup（ehawkin/zotero-mcp-setup）への macOS GUI インストーラリンクも README にあります。

semantic 拡張は ChromaDB と embedding モデルを引き込むため、ディスクと初回索引時間が増えます。update-db は --fulltext 無しから試すのが現実的です。 一次資料に無い挙動は試験環境でのみ確認し、本番反映は release タグと公式 docs の差分を記録したうえで行ってください。 第2追記として、54yyyu-zotero-mcp-deep-analysis の README 記載範囲を超えない確認項目を残します。compose 例・env 名・port 番号は素材どおり再読し、自分の OS/arch に合う release 資産だけを選んでください。 第8追記として、54yyyu-zotero-mcp-deep-analysis の README 記載範囲を超えない確認項目を残します。compose 例・env 名・port 番号は素材どおり再読し、自分の OS/arch に合う release 資産だけを選んでください。

semantic・pdf・scite・all オプション拡張

Optional Extras 表は semantic が ChromaDB、sentence-transformers、OpenAI/Gemini embeddings、pdf が PyMuPDF アウトラインと EPUB 注釈、scite が引用 tally と retraction alert（アカウント不要）、all が全部と説明しています。例：`uv tool install "zotero-mcp-server[semantic]"`。基本のみなら extras なしで README は述べます。Semantic Search 節は `[semantic]` 必須、埋め込みモデル default ローカル all-MiniLM-L6-v2、OpenAI、Gemini、Ollama 選択、`zotero-mcp setup --semantic-config-only` 設定、`zotero-mcp update-db` インデックス構築、--fulltext は遅い全文索引と README にあります。

hybrid モードは書き込みだけ Web API に逃がす設計です。API key の権限と library type を setup 時に間違えると read-only のまま書込 tool が失敗します。 一次資料に無い挙動は試験環境でのみ確認し、本番反映は release タグと公式 docs の差分を記録したうえで行ってください。 第3追記として、54yyyu-zotero-mcp-deep-analysis の README 記載範囲を超えない確認項目を残します。compose 例・env 名・port 番号は素材どおり再読し、自分の OS/arch に合う release 資産だけを選んでください。 第9追記として、54yyyu-zotero-mcp-deep-analysis の README 記載範囲を超えない確認項目を残します。compose 例・env 名・port 番号は素材どおり再読し、自分の OS/arch に合う release 資産だけを選んでください。

ローカル・Web・ハイブリッドと ZOTERO_LOCAL

Flexible Access Methods は local offline（API key 不要）、Web API cloud、hybrid read local write web です。ローカルモードは Zotero 設定で allow other applications on this computer to communicate を有効化し読み取り専用と README は述べます。ZOTERO_LOCAL=true を API key と library id と併用すると hybrid：local read、web write。リモートは `zotero-mcp setup --no-local --api-key ... --library-id ...`。環境変数 ZOTERO_LIBRARY_TYPE、WebDAV 資格情報等があり、shell env が client config を上書きすると README にあります。

zotero-cli は CI やスクリプト向けで、MCP クライアントが無い環境でも同じ設定ファイルを共有できます。 一次資料に無い挙動は試験環境でのみ確認し、本番反映は release タグと公式 docs の差分を記録したうえで行ってください。 第4追記として、54yyyu-zotero-mcp-deep-analysis の README 記載範囲を超えない確認項目を残します。compose 例・env 名・port 番号は素材どおり再読し、自分の OS/arch に合う release 資産だけを選んでください。 第10追記として、54yyyu-zotero-mcp-deep-analysis の README 記載範囲を超えない確認項目を残します。compose 例・env 名・port 番号は素材どおり再読し、自分の OS/arch に合う release 資産だけを選んでください。

ZOTERO_MCP_TOOLSETS と zotero-cli スタンドアロン

Tools 節は MCP が毎リクエスト全 tool schema を送るため ZOTERO_MCP_TOOLSETS で groups 制御と README は説明します。default profile は core に libraries、search-admin、pdf-geometry。scite、duplicates、discovery 等は default off。zotero_search_items、zotero_get_item_metadata、zotero_add_by_doi、zotero_manage_note 等が README に列挙され、可用性は active toolsets 依存です。Standalone CLI zotero-cli は同設定で AI 不要、search エイリアス s、ann 等、--json 全コマンド対応。Agent skill は `zotero-mcp install-skill` で shell 利用 harness 向け 98 token frontmatter と README context cost 表があります。

install-skill ルートは shell 付き harness 向けで、Claude Desktop だけ使うユーザーには MCP server 側が README 上の正攻法です。 一次資料に無い挙動は試験環境でのみ確認し、本番反映は release タグと公式 docs の差分を記録したうえで行ってください。 第5追記として、54yyyu-zotero-mcp-deep-analysis の README 記載範囲を超えない確認項目を残します。compose 例・env 名・port 番号は素材どおり再読し、自分の OS/arch に合う release 資産だけを選んでください。 第11追記として、54yyyu-zotero-mcp-deep-analysis の README 記載範囲を超えない確認項目を残します。compose 例・env 名・port 番号は素材どおり再読し、自分の OS/arch に合う release 資産だけを選んでください。

Write 操作・Scite 拡張と README 未記載点

Write Operations は DOI 追加（Unpaywall、arXiv、Semantic Scholar、PMC cascade）、URL/local file 追加、collections、metadata、tags batch、duplicate merge dry-run、hybrid write と README にあります。Scite `[scite]` extra は citation tallies と retraction alerts で public API、Scite アカウント不要と README は述べます。テストは uv run pytest tests/（README 294 tests）と docs/integration-test-plan.md 45-point live plan です。zotero-mcp 試行は setup 後 Claude Desktop から search tool、DOI 追加、semantic なら update-db 後 semantic search の順が README 記載機能に沿った確認です。

Scite 拡張は公開 API 依存であり、レート制限や応答形式変更は README に SLA がありません。 一次資料に無い挙動は試験環境でのみ確認し、本番反映は release タグと公式 docs の差分を記録したうえで行ってください。 第6追記として、54yyyu-zotero-mcp-deep-analysis の README 記載範囲を超えない確認項目を残します。compose 例・env 名・port 番号は素材どおり再読し、自分の OS/arch に合う release 資産だけを選んでください。 第12追記として、54yyyu-zotero-mcp-deep-analysis の README 記載範囲を超えない確認項目を残します。compose 例・env 名・port 番号は素材どおり再読し、自分の OS/arch に合う release 資産だけを選んでください。

編集部の結論

Claude Desktop 等 MCP クライアントから Zotero 文献を検索・要約したい研究者向きです。`uv tool install zotero-mcp-server` と `zotero-mcp setup` でローカル API を有効化し、semantic 検索が必要なら `[semantic]` 拡張を入れて `zotero-mcp update-db` でインデックスを作ってから DOI 追加ツールを試してください。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes