이 프로젝트는 Zotero용 모델 컨텍스트 프로토콜(MCP)을 구현한 파이썬 서버로, AI 어시스턴트 내에서 Zotero 라이브러리에 접근할 수 있게 합니다. MCP 클라이언트에서 사용할 수 있도록 Zotero와의 소규모지만 최대한 유용한 상호작용 세트를 구현하는 것을 목표로 합니다.

특징

이 MCP 서버는 다음과 같은 도구를 제공합니다:

• zotero_search_items: 텍스트 쿼리를 사용해 조테로 라이브러리 내 항목을 검색합니다
• zotero_item_metadata: 특정 Zotero 항목에 대한 전체 메타데이터를 얻으며, 출판 세부사항, 식별자, 타임스탬프, 라이브러리 정보로 그룹화된 모든 채워진 필드를 포함합니다
• zotero_item_fulltext: 특정 조테로 항목의 전체 텍스트 (i.e. PDF 내용)

이 데이터는 어떤 MCP 클라이언트나 MCP 인스펙터를 통해 발견하고 접근할 수 있습니다.

각 도구는 Zotero 아이템에서 관련 정보를 담은 서식화된 텍스트를 반환하며, Claude와 같은 AI 비서가 순차적으로 아이템을 검색한 후 메타데이터나 텍스트 내용을 검색할 수 있습니다.

설치

이 서버는 Zotero 데스크톱 애플리케이션에서 제공하는 로컬 API를 통해 실행되거나 Zotero 웹 API를 통해 실행할 수 있습니다.

Model Context Protocol server for Zotero

This project is a python server that implements the Model Context Protocol (MCP) for Zotero, giving you access to your Zotero library within AI assistants. It is intended to implement a small but maximally useful set of interactions with Zotero for use with MCP clients.

Features

This MCP server provides the following tools:

• zotero_search_items: Search for items in your Zotero library using a text query
• zotero_item_metadata: Get the complete metadata for a specific Zotero item, covering every populated field grouped into publication details, identifiers, timestamps, and library information
• zotero_item_fulltext: Get the full text of a specific Zotero item (i.e. PDF contents)

These can be discovered and accessed through any MCP client or through the MCP Inspector.

Each tool returns formatted text containing relevant information from your Zotero items, and AI assistants such as Claude can use them sequentially, searching for items then retrieving their metadata or text content.

Installation

This server can either run against either a local API offered by the Zotero desktop application) or through the Zotero Web API. The local API can be a bit more responsive, but requires that the Zotero app be running on the same computer with the API enabled. To enable the local API, do the following steps:

1. Open Zotero and open “Zotero Settings”
2. Under the “Advanced” tab, check the box that says “Allow other applications on this computer to communicate with Zotero”.

To use the Zotero Web API, you’ll need to create an API key and find your Library ID (usually your User ID) in your Zotero account settings here:

These are the available configuration options:

• ZOTERO_LOCAL=true: Use the local Zotero API (default: false, see note below)
• ZOTERO_API_KEY: Your Zotero API key (not required for the local API)