Skip to main content
Glama
Zotero MCP

Zotero MCP

by 404Simon

Zotero MCP

로컬 Zotero 라이브러리용 읽기 전용 MCP 서버입니다. 컬렉션을 탐색하고, 논문 메타데이터를 확인하고, PDF에서 전체 텍스트를 추출합니다. 모두 FastMCP 도구를 통해 제공됩니다.

요구 사항

  • Zotero 데스크톱이 ~/Zotero/zotero.sqlite에 동기화되어 있어야 합니다 (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.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    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