Skip to main content
Glama
Zotero MCP

Zotero MCP

by 404Simon

Zotero MCP

読み取り専用のMCPサーバーで、ローカルのZoteroライブラリを操作します。コレクションの閲覧、論文メタデータの確認、PDFからの全文抽出を、すべてFastMCPツールで行います。

要件

  • ~/Zotero/zotero.sqlite に同期されたZoteroデスクトップ(Linuxのデフォルト)

  • Python 3.13+

  • uv

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

すべてのコレクションと論文を、整形されたツリーとして一覧表示します。オプションでコレクション名、論文タイトル、または著者でフィルタリングできます。

引数

型

説明

query

string(オプション)

コレクション名、論文タイトル、または著者でフィルタリング(大文字小文字を区別しない)

各論文の行には、アイテムキーが [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. Bumgarner

paper_details

アイテムキーで論文の完全なメタデータを取得します。キーは list_library の出力([KEY] として表示)または search_papers の結果から取得します。

引数

型

説明

item_key

string(必須)

Zoteroアイテムキー(list_library の出力または search_papers の結果に [KEY] として表示)

タイトル、タイプ、キー、追加日/更新日、著者、すべてのフィールドメタデータ、コレクションの所属、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.pdf

search_papers

タイトルまたは著者で全論文を検索します。アイテムキー付きの構造化された結果を返します。

引数

型

説明

query

string(必須)

検索語(大文字小文字を区別せず、タイトルと著者に一致)

[{"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添付ファイルが必要です。

引数

型

説明

item_key

string(必須)

Zoteroアイテムキー(list_library の出力または search_papers の結果に [KEY] として表示)

タイトル、著者、アブストラクトから始まる、抽出された生のテキストを返します:

            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 tools
list_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

    A4.1/5.0

    Scored across 4 tools

    Disambiguation4/5

    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.

    Naming Consistency3/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Read-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.
      11
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Minimal 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.
      6
      1
      MIT