Zotero MCP Aef2f6a3

MCP搜索检索

提供方 cookjohn

搜索检索 未标注 无需鉴权 社区 / 第三方 Claude DesktopClaudeCursor

Zotero MCP是一个开源项目,通过模型上下文协议(MCP)将AI能力与Zotero文献管理工具无缝集成,提供智能搜索、内容提取、注释分析等功能,适用于学术研究和写作。

一句话选型结论

按资料字段整理

Zotero MCP Aef2f6a3 属于搜索检索类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude Desktop、Claude、Cursor,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类搜索检索 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 783 仓库热度,无公开仓库时显示未标注
工具数 19 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

搜索检索
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量19暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

文献管理TypeScript混合部署AI集成智能搜索内容提取语义搜索

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 19 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
联网搜索取证

让模型查最新资料并给出出处。

资料聚合

把一个主题的网页、文档集中抓回来整理。

情报与竞品检索

按关键词持续检索行业动态和竞品信息。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 19 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在搜索检索场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zotero MCP Aef2f6a3当前 19 未标注 未标注 无 2026-05-17
Brave Search 433812ff 2 未标注 未标注 无 2026-05-17
Sequentialthinking 1 SSE · 服务端推送 远程部署 有 2026-05-18
Baidu Netdisk 未标注 未标注 未标注 无 2026-05-17
ragflow 未标注 stdio · 本地进程 本地部署 有 2026-04-11
mindsdb (430e18) 未标注 未标注 未标注 有 2026-05-17

服务器档案

搜索检索
字段来自项目仓库与公开索引,中文说明由本站标注
提供方cookjohn上游标注的维护方 cookjohn
分类搜索检索本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

12.2 KB
来自项目仓库与上游目录的原文,未做删改

Zotero MCP - Model Context Protocol Integration for Zotero

Zotero MCP is an open-source project designed to seamlessly integrate powerful AI capabilities with the leading reference management tool, Zotero, through the Model Context Protocol (MCP). This project consists of two core components: a Zotero plugin and an MCP server, which work together to provide AI assistants (like Claude) with the ability to interact with your local Zotero library.
This README is also available in: :cn: 简体中文 | :gb: English.


Fork us on Wechat

📚 Project Overview

The Zotero MCP server is a tool server based on the Model Context Protocol that provides seamless integration with the Zotero reference management system for AI applications like Claude Desktop. Through this server, AI assistants can:

  • 🔍 Smart Search: Multi-dimensional library search (title/creator/year/tags/fulltext/semantic) with boolean operators and relevance scoring
  • 📖 Content Extraction: Extract PDF full-text, notes, abstracts, webpage snapshots with fine-grained mode control
  • 📝 Annotation Analysis: Search and analyze PDF highlights and annotations by color, tags, and keywords
  • 📂 Collection Browsing: Browse and search collection hierarchies, retrieve items within collections
  • 🧠 Semantic Search: AI-powered concept matching via embedding vectors, discover related literature across languages
  • ✏️ Write Operations: Create notes, manage tags, update metadata, create new items and attach PDFs
  • 💾 Full-text Database: Access and search cached PDF full-text content

This enables AI assistants to help you with literature reviews, citation management, content analysis, annotation organization, knowledge base management, and more.

🚀 Project Structure

This project now features a unified architecture with an integrated MCP server:

  • zotero-mcp-plugin/: A Zotero plugin with integrated MCP server that communicates directly with AI clients via Streamable HTTP protocol
  • IMG/: Screenshots and documentation images
  • README.md / README-zh.md: Documentation files

Unified Architecture:```
AI Client ↔ Streamable HTTP ↔ Zotero Plugin (with integrated MCP server)


This eliminates the need for a separate MCP server process, providing a more streamlined and efficient integration.

---

## 🚀 Quick Start Guide

This guide is intended to help general users quickly configure and use Zotero MCP, enabling your AI assistant to work seamlessly with your Zotero library.

### 1. Installation (For General Users)

**What is Zotero MCP?**

Simply put, Zotero MCP is a bridge connecting your AI client (like Cherry Studio, Gemini CLI, Claude Desktop, etc.) and your local Zotero reference management software. It allows your AI assistant to directly search, query, and cite references from your Zotero library, greatly enhancing academic research and writing efficiency.

**Two-Step Quick Start:**

1.  **Install the Plugin**:
    *   Go to the project's Releases Page to download the latest `zotero-mcp-plugin-x.x.x.xpi` file.
    *   In Zotero, install the `.xpi` file via `Tools -> Add-ons`.
    *   Restart Zotero.

2.  **Configure the Plugin**:
    *   In Zotero's `Preferences -> Zotero MCP Plugin` tab, configure your connection settings:
        - **Enable Server**: Start the integrated MCP server
        - **Port**: Default is `23120` (you can change this if needed)
        - **Generate Client Configuration**: Click this button to get configuration for your AI client

---

### 2. Connect to AI Clients

**Important**: The Zotero plugin now includes an **integrated MCP server** that uses the Streamable HTTP protocol. No separate server installation is needed.

#### Streamable HTTP Connection

The plugin uses Streamable HTTP, which enables real-time bidirectional communication with AI clients:

1. **Enable Server** in the Zotero plugin preferences
2. **Generate Client Configuration** by clicking the button in plugin preferences
3. **Copy the generated configuration** to your AI client

#### Supported AI Clients

- **Claude Desktop**: Streamable HTTP MCP support
- **Cherry Studio**: Streamable HTTP support
- **Cursor IDE**: Streamable HTTP MCP support
- **Custom implementations**: Streamable HTTP protocol

For detailed client-specific configuration instructions, see the Chinese README.

---

## 👨‍💻 Developer Guide

### Prerequisites

- **Zotero** 7.0 or higher
- **Node.js** 18.0 or higher
- **npm** or **yarn**
- **Git**

### Step 1: Install and Configure the Zotero Plugin

1.  Download the latest `zotero-mcp-plugin.xpi` from the Releases Page.
2.  Install it in Zotero via `Tools -> Add-ons`.
3.  Enable the server in `Preferences -> Zotero MCP Plugin`.

### Step 2: Development Setup

1.  Clone the repository:```bash
    git clone https://github.com/cookjohn/zotero-mcp.git
    cd zotero-mcp
    ```

2.  Set up the plugin development environment:```bash
    cd zotero-mcp-plugin
    npm install
    npm run build
    ```

3.  Load the plugin in Zotero:```bash
    # For development with auto-reload
    npm run start

    # Or install the built .xpi file manually
    npm run build
    ```

### Step 3: Connect AI Clients (Development)

The plugin includes an integrated MCP server that uses Streamable HTTP:

1.  **Enable the server** in Zotero plugin preferences
2.  **Generate client configuration** using the plugin's built-in generator
3.  **Configure your AI client** with the generated Streamable HTTP configuration

Example configuration for Claude Desktop:```json
{
  "mcpServers": {
    "zotero": {
      "transport": "streamable_http",
      "url": "http://127.0.0.1:23120/mcp"
    }
  }
}

🧩 Features

zotero-mcp-plugin Features

  • Integrated MCP Server: Built-in MCP server using Streamable HTTP protocol, no separate process needed
  • Advanced Search Engine: Full-text search with boolean operators, relevance scoring, filtering by title, creator, year, tags, item type, and more
  • Unified Content Extraction: Extract content from PDFs, attachments, notes, abstracts, webpage snapshots with four modes (minimal/preview/standard/complete)
  • Smart Annotation System: Search and retrieve PDF highlights, annotations, and notes by color, tags, and keywords with intelligent ranking
  • Collection Management: Browse, search collection hierarchies, get collection details, subcollections, and item lists
  • Semantic Search: AI-powered semantic search using embedding vectors
    • Supports OpenAI and Ollama embedding APIs (auto-detection)
    • Vector indexing with SQLite-vec storage
    • Index status column in main library view
    • Collection/item context menu for index management
  • Write Operations: Create/modify notes, manage tags, update metadata fields, create new items and reparent standalone PDFs
  • Full-text Database: Cached PDF full-text database with list, search, get, and stats operations
  • Standalone Attachment Management: Search and manage standalone PDF items without parent metadata
  • Client Configuration Generator: Automatically generates configuration for various AI clients
  • Security: Local-only operation ensuring complete data privacy
  • User-Friendly: Easy configuration through Zotero preferences interface

📸 Screenshots

Here are some screenshots demonstrating the functionality of Zotero MCP:

Feature Screenshot
Feature Demonstration
Literature Search
Viewing Metadata
Full-text Reading 1
Full-text Reading 2
Searching Attachments (Gemini CLI)
Reading PDF (Gemini CLI)

🔧 API Reference (MCP Tools)

The integrated MCP server provides 29 tools in 5 categories:

1. Search & Query (7 tools)

search_library

Advanced library search with multi-dimensional filtering, boolean operators, relevance scoring, and intelligent mode control.
- q, title, titleOperator, yearRange, fulltext, fulltextMode, itemType, includeAttachments, mode (minimal/preview/standard/complete), relevanceScoring, sort, limit, offset

search_annotations

Search annotations by query, colors, or tags with intelligent ranking.
- q, itemKeys, types (note/highlight/annotation/ink/text/image), colors, tags, mode, limit, offset

search_fulltext

Full-text search across all document content with context snippets.
- q (required), itemKeys, mode, contextLength, caseSensitive

search_collections

Search collections by name. Params: q, limit.

get_item_details

Get complete metadata for a single item. Params: itemKey (required), mode.

get_item_abstract

Get item abstract/summary. Params: itemKey (required), format (json/text).

get_content

Unified content extraction: PDF full-text, notes, abstracts, webpage snapshots from items or specific attachments.
- itemKey, attachmentKey, mode, include (pdf/attachments/notes/abstract/webpage), contentControl, format (json/text)

2. Collection Management (4 tools)

get_collections

Get all collections. Params: mode, limit, offset.

get_collection_details

Get details of a specific collection. Params: collectionKey (required).

get_collection_items

Get items in a collection. Params: collectionKey (required), limit, offset.

get_subcollections

Get subcollections. Params: collectionKey (required), limit, offset, recursive.

3. Semantic Search (3 tools, can be disabled in preferences)

semantic_search

AI-powered semantic search using embedding vectors. Finds conceptually related content even without exact keyword matches.
- query (required), topK, minScore, language (zh/en/all)

find_similar

Find items semantically similar to a given item.
- itemKey (required), topK, minScore

semantic_status

Get semantic search service status and index statistics. No parameters required.

4. Full-text Database (1 tool)

fulltext_database

Access cached full-text content database (read-only).
- action (required: list/search/get/stats), query, itemKeys, limit

5. Write Operations (6 tools, can be disabled in preferences)

write_note

Create or modify Zotero notes. Supports Markdown auto-conversion to HTML.
- action (required: create/update/append), parentKey, noteKey, content (required), tags

write_tag

Add, remove, or replace tags on items.
- action (required: add/remove/set), itemKey (required), tags (required)

write_metadata

Update metadata fields on items (title, abstract, date, DOI, creators, etc.).
- itemKey (required), fields, creators

write_item

Create new items, reparent existing attachments, or import local files as attachments.
- action (required: create/reparent/import), itemType, fields, creators, tags, attachmentKeys, parentKey, filePath, parentItemKey, title, linkMode (import: imported_file copies into Zotero storage, linked_file links in place — personal library only), libraryID

add_by_identifier

Import items by identifier (DOI, arXiv, ISBN, PMID, ADS bibcode) using Zotero's native resolvers — the same pipeline as the desktop "magic wand", including translator metadata and automatic attachment fetching.
- identifiers (required), libraryID, collectionKey, saveAttachments, duplicates, titleDuplicates, dryRun, async, jobID

trash_item

Move one or more items to Zotero Trash. Items stay recoverable until the user empties Trash; permanent deletion is not supported (permanent is rejected).
- itemKeys (required, array of item keys; deduplicated), libraryID


🤝 Contributing

Contributions are welcome! Please feel free to submit pull requests, report issues, or suggest enhancements.

  1. Fork the repository.
  2. Create your feature branch (git checkout -b feature/AmazingFeature).
  3. Commit your changes (git commit -m 'Add some AmazingFeature').
  4. Push to the branch (git push origin feature/AmazingFeature).
  5. Open a Pull Request.

📄 License

This project is licensed under the MIT License.

🙏 Acknowledgements

  • Zotero - An excellent open-source reference management tool.
  • Model Context Protocol - The protocol for AI tool integration.


    Contact us

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Zotero MCP Aef2f6a3 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Zotero MCP Aef2f6a3 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Zotero MCP Aef2f6a3 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Zotero MCP Aef2f6a3 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Zotero MCP Aef2f6a3 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Zotero MCP Aef2f6a3 能提供哪些能力?

资料显示约 19 个工具;能力标签包括 文献管理、内容提取、TypeScript、Claude、搜索。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。