Zotero MCP
Zotero MCP
読み取り専用のMCPサーバーで、ローカルのZoteroライブラリを操作します。コレクションの閲覧、論文メタデータの確認、PDFからの全文抽出を、すべてFastMCPツールで行います。
要件
~/Zotero/zotero.sqliteに同期されたZoteroデスクトップ(Linuxのデフォルト)Python 3.13+
Related MCP server: zotero-mcp
設定
これはMCPサーバーです。コーディングエージェントのMCP設定に登録すると、エージェントがそのツールを使用できるようになります。
ほとんどのエージェントは同様の設定を受け付けます。たとえばOpencodeでは、opencode.json に追加します:
{
"mcp": {
"zotero-mcp": {
"command": [
"uvx",
"--from",
"git+https://github.com/404Simon/zotero-mcp",
"zotero-mcp"
],
"enabled": true,
"type": "local"
}
}
}この設定後、エージェントはツールを自動的に発見するため、次のように質問するだけで済みます:
「私のライブラリにあるRAG関連の論文はどれですか?また、最新の論文のアブストラクトは何ですか?」
ツール
list_library
すべてのコレクションと論文を、整形されたツリーとして一覧表示します。オプションでコレクション名、論文タイトル、または著者でフィルタリングできます。
引数 | 型 | 説明 |
|
| コレクション名、論文タイトル、または著者でフィルタリング(大文字小文字を区別しない) |
各論文の行には、アイテムキーが [KEY] の角括弧で含まれます。そのキーを paper_details または paper_text で使用します。フィルタリングされた出力には、一致するコレクションとその祖先を含む、一致するサブツリーのみが表示されます。
├── AI (2 papers)
│ [N3G6XKB9] [preprint] Retrieval-Augmented Generation for Knowledge-Intensive NLP Tasks (2021) - Patrick Lewis
│ [PPJJCMXJ] [book] Grundkurs Künstliche Intelligenz: eine praxisorientierte Einführung (2021) - Wolfgang Ertel
├── Bachelorarbeit (42 papers)
│ ├── GraalVM (4 papers)
│ │ [DSUERN67] [book] Supercharge your applications with GraalVM ... (2021) - A. B. Vijay Kumar
│ └── Java Performance (1 papers)
│ [Q3ANMGC3] [conferencePaper] Applying Optimizations for Dynamically-typed Languages to Java (2017) - Matthias Grimmer
│ [MTSF327R] [book] Pro Spring Boot 3: An Authoritative Guide with Best Practices (2024) - Felipe Gutierrez
├── Studienarbeit (49 papers)
│ [T3ZCDWC7] [preprint] MMLU-Pro: A More Robust and Challenging Multi-Task Language Understanding Benchmark (2024) - Yubo Wang
├── T3000 (4 papers)
│ [DTZF77Y4] [webpage] Conventional Commits (n.d.) - Unknown
├── TheGreenEpoch (8 papers)
│ [YINRQ63P] [preprint] Distributed LLM Pretraining During Renewable Curtailment Windows (2026) - Philipp Wiesner
└── VesSkel (19 papers)
[ZUXQUGHW] [journalArticle] Open-source analysis and visualization of segmented vasculature datasets with VesselVio (2022) - Jacob R. Bumgarnerpaper_details
アイテムキーで論文の完全なメタデータを取得します。キーは list_library の出力([KEY] として表示)または search_papers の結果から取得します。
引数 | 型 | 説明 |
|
| Zoteroアイテムキー(list_library の出力または search_papers の結果に |
タイトル、タイプ、キー、追加日/更新日、著者、すべてのフィールドメタデータ、コレクションの所属、PDF添付情報を返します:
Title: MMLU-Pro: A More Robust and Challenging Multi-Task Language Understanding Benchmark
Type: preprint
Key: T3ZCDWC7
Authors: Yubo Wang, Xueguang Ma, Ge Zhang, Yuansheng Ni, ...
date: 2024-11-06
DOI: 10.48550/arXiv.2406.01574
url: http://arxiv.org/abs/2406.01574
abstractNote: In the age of large-scale language models, benchmarks like the Massive Multitask Language Understanding (MMLU) ...
Collections: Studienarbeit
PDF: Wang et al. - 2024 - MMLU-Pro A More Robust and Challenging Multi-Task Language Understanding Benchmark.pdfsearch_papers
タイトルまたは著者で全論文を検索します。アイテムキー付きの構造化された結果を返します。
引数 | 型 | 説明 |
|
| 検索語(大文字小文字を区別せず、タイトルと著者に一致) |
[{"key": "ZUXQUGHW",
"title": "Open-source analysis and visualization of segmented vasculature datasets with VesselVio",
"type": "journalArticle", "year": "2022",
"first_author": "Jacob R. Bumgarner",
"authors": ["Jacob R. Bumgarner", "Randy J. Nelson"],
"url": "https://linkinghub.elsevier.com/retrieve/pii/S2667237522000443"},
{"key": "6DU4XPQQ",
"title": "Robust Vessel Segmentation in Fundus Images",
"type": "journalArticle", "year": "2013",
"first_author": "A. Budai",
"authors": ["A. Budai", "R. Bock", "A. Maier", "J. Hornegger", "G. Michelson"],
"url": "http://www.hindawi.com/journals/ijbi/2013/154860/"}]paper_text
PyMuPDF を使用して論文PDFの全文を抽出します(Pythonの依存関係としてバンドルされており、システムツールは不要です)。~/Zotero/storage/ に保存されたPDF添付ファイルが必要です。
引数 | 型 | 説明 |
|
| Zoteroアイテムキー(list_library の出力または search_papers の結果に |
タイトル、著者、アブストラクトから始まる、抽出された生のテキストを返します:
MMLU-Pro: A More Robust and Challenging
Multi-Task Language Understanding Benchmark
1Yubo Wang∗, 1Xueguang Ma∗, 1Ge Zhang, 1Yuansheng Ni, 1Abhranil Chandra, ...
1University of Waterloo, 2University of Toronto, 3Carnegie Mellon University
Abstract
In the age of large-scale language models, benchmarks like the Massive Multitask
Language Understanding (MMLU) have been pivotal in pushing the boundaries
of what AI can achieve in language comprehension and reasoning across diverse
domains. ...ファイル構造
src/
main.py # FastMCP server, tool definitions
zotero.py # SQLite queries, data models, formattingデータベースは ~/Zotero/zotero.sqlite から直接読み取られます。PDFは ~/Zotero/storage/ から解決されます。APIキーは不要です。
Available Tools
4 toolslist_libraryA
List collections and papers in the Zotero library. Optionally filter by collection name, paper title, or author. Each paper line includes its item key in [KEY] brackets — use that key in paper_details or paper_text.
Inputs: query. Returns: result
paper_detailsA
Get full metadata for a paper by its item key. Obtain the item_key from list_library output (shown as [KEY] before each paper) or from search_papers results.
Inputs: item_key (required). Returns: result
paper_textA
Extract full text from a paper's PDF using pdftotext. Obtain the item_key from list_library output (shown as [KEY] before each paper) or from search_papers results.
Inputs: item_key (required). Returns: result
search_papersA
Search papers by title or author and return structured results with item keys. Each result includes key, title, type, year, first_author, authors, and url. Use the key in paper_details or paper_text to get full metadata or PDF text.
Inputs: query (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
The tools are mostly distinct: list_library for browsing, search_papers for targeted search, paper_details for metadata, and paper_text for PDF content. However, list_library and search_papers both filter by title/author, which could cause some confusion.
The naming mixes verb_noun patterns (list_library, search_papers) with noun_noun patterns (paper_details, paper_text). While the paper_* prefix helps, the overall convention is not fully consistent.
With only 4 tools, the server is well-scoped for its purpose of accessing a Zotero library. Each tool is essential and there is no unnecessary bloat.
The tool set covers the core read workflow: discovering papers (list/search), retrieving full metadata, and extracting PDF text. Missing write operations and a dedicated collection endpoint are minor gaps that agents can work around.
Related MCP Connectors
Remote MCP server for full read/write access to a Zotero library
Zotero MCP server for Claude and ChatGPT: search, citations, safe writes, PDF passages and pages.
Read-only MCP server exposing a user ORANO library to their own AI agent.
Personal knowledge base MCP server with semantic search, auto-categorization, metadata extraction
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceRead-only MCP server for browsing, searching, and exporting a Zotero library from AI assistants.-
- AlicenseAqualityDmaintenanceRead-only MCP server that lets Claude or any MCP client search and retrieve metadata, notes, full text, citations, and BibTeX from your local Zotero library via its built-in API.11MIT
- AlicenseNot gradedqualityBmaintenanceLocal read-only MCP server for Zotero libraries, enabling search, retrieval, and full-text access via the Zotero Web API.MIT
- AlicenseAqualityCmaintenanceMinimal Zotero MCP server that enables searching your Zotero library, discovering papers across eight sources, downloading PDFs via a multi-level cascade, and importing them into Zotero.61MIT