このプロジェクトはPythonサーバーで、Zotero用のModel Context Protocol(MCP)を実装し、AIアシスタント内でZoteroライブラリにアクセスできるようにしています。MCPクライアント向けに、Zoteroとの最小限ながらも最大限に役立つ相互作用を実装することを目的としています。

特徴

このMCPサーバーは以下のツールを提供します:

• zotero_search_items:テキストクエリでZoteroライブラリ内のアイテムを検索
• zotero_item_metadata:特定のZoteroアイテムの完全なメタデータを取得し、すべての埋め込まれたフィールドを出版詳細、識別子、タイムスタンプ、ライブラリ情報にまとめてまとめられます
• zotero_item_fulltext:特定のゾテロアイテムの全文(i.e. PDF内容)

これらは任意のMCPクライアントやMCPインスペクターを通じて発見・アクセス可能です。

各ツールはZoteroアイテムに関連する情報を含むフォーマット済みのテキストを返し、ClaudeのようなAIアシスタントはそれらを順番に使用し、アイテムを検索してメタデータやテキスト内容を取得できます。

設置

このサーバーは、Zoteroデスクトップアプリケーションが提供するローカルAPIに対して動作するか、Zotero Web 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)