Zotero-MCP服务器

Name: Zotero-MCP服务器
Author: cookjohn

作者：cookjohn149 星标更新：2025-11-21

安装使用来源：spider==github.com

项目介绍

Zotero MCP - Zotero 的模型上下文协议集成

Zotero MCP 是一个开源项目，旨在通过模型上下文协议（MCP）无缝地将强大的人工智能能力与领先的参考管理工具 Zotero 集成。该项目由两个核心组件组成：一个 Zotero 插件和一个 MCP 服务器，它们协同工作，使 AI 助手（如 Claude）能够与您的本地 Zotero 库进行交互。 此 README 还提供以下语言版本：:cn: 简体中文 | :gb: 英文.

在微信上关注我们

公众号	论坛

📚 项目概述

Zotero MCP 服务器是一个基于模型上下文协议的工具服务器，它提供了与 Zotero 参考管理系统无缝集成的能力，适用于像 Claude Desktop 这样的 AI 应用。通过这个服务器，AI 助手可以：

🔍 智能搜索您的 Zotero 库
📖 获取关于参考文献的详细信息
🏷️ 根据标签、作者、年份等过滤参考文献
🔗 准确地通过 DOI 和 ISBN 等标识符定位参考文献

这使得 AI 助手能够帮助您完成学术任务，如文献综述、引用管理和研究辅助。

🚀 项目结构

本项目现在采用统一架构，集成了 MCP 服务器：

zotero-mcp-plugin/: 一个 Zotero 插件，内置 MCP 服务器，通过可流式传输的 HTTP 协议直接与 AI 客户端通信
IMG/: 屏幕截图和文档图片
README.md / README-zh.md: 文档文件

统一架构：

AI 客户端 ↔ 可流式传输的 HTTP ↔ Zotero 插件（内置 MCP 服务器）

这消除了对单独 MCP 服务器进程的需求，提供了更简洁高效的集成。

🚀 快速入门指南

本指南旨在帮助普通用户快速配置和使用 Zotero MCP，使您的 AI 助手能够无缝地与您的 Zotero 库协作。

1. 安装（针对普通用户）

什么是 Zotero MCP？

简单来说，Zotero MCP 是连接您的 AI 客户端（如 Cherry Studio、Gemini CLI、Claude Desktop 等）和本地 Zotero 参考管理软件的桥梁。它允许您的 AI 助手直接搜索、查询和引用您的 Zotero 库中的参考文献，大大提高了学术研究和写作效率。

两步快速开始：

安装插件：
- 前往项目的发布页面，下载最新的 zotero-mcp-plugin-x.x.x.xpi 文件。
- 在 Zotero 中，通过 工具 -> 扩展程序 安装 .xpi 文件。
- 重启 Zotero。
配置插件：
- 在 Zotero 的 偏好设置 -> Zotero MCP 插件 标签页中，配置您的连接设置：
  - 启用服务器：启动内置的 MCP 服务器
  - 端口：默认是 23120（如有需要可更改）
  - 生成客户端配置：点击此按钮以获取您的 AI 客户端配置

2. 连接到 AI 客户端

重要：Zotero 插件现在包括一个内置的 MCP 服务器，使用可流式传输的 HTTP 协议。无需单独安装服务器。

可流式传输的 HTTP 连接

插件使用可流式传输的 HTTP，这使得与 AI 客户端进行实时双向通信成为可能：

在 Zotero 插件偏好设置中启用服务器
通过点击插件偏好设置中的按钮生成客户端配置
将生成的配置复制到您的 AI 客户端

支持的 AI 客户端

Claude Desktop: 支持可流式传输的 HTTP MCP
Cherry Studio: 支持可流式传输的 HTTP
Cursor IDE: 支持可流式传输的 HTTP MCP
自定义实现: 支持可流式传输的 HTTP 协议

有关详细的客户端特定配置说明，请参阅中文 README。

👨‍💻 开发者指南

前提条件

Zotero 7.0 或更高版本
Node.js 18.0 或更高版本
npm 或 yarn
Git

第一步：安装和配置 Zotero 插件

从发布页面下载最新的 zotero-mcp-plugin.xpi。
通过 工具 -> 扩展程序 在 Zotero 中安装它。
在 偏好设置 -> Zotero MCP 插件 中启用服务器。

第二步：开发环境设置

克隆仓库：

git clone https://github.com/cookjohn/zotero-mcp.git
cd zotero-mcp

设置插件开发环境：

cd zotero-mcp-plugin
npm install
npm run build

在 Zotero 中加载插件：

# 开发时自动重新加载
npm run start

# 或手动安装构建的 .xpi 文件
npm run build

第三步：连接 AI 客户端（开发）

插件包括一个使用可流式传输的 HTTP 的内置 MCP 服务器：

在 Zotero 插件偏好设置中启用服务器
使用插件内置生成器生成客户端配置
使用生成的可流式传输的 HTTP 配置配置您的 AI 客户端

Claude Desktop 示例配置：

{
  "mcpServers": {
    "zotero": {
      "transport": "streamable_http",
      "url": "http://127..0.1:23120/mcp"
    }
  }
}

🧩 特性

`zotero-mcp-plugin` 特性

内置 MCP 服务器: 使用可流式传输的 HTTP 协议
可流式传输的 HTTP 协议: 与 AI 客户端进行实时双向通信
高级搜索引擎: 支持按标题、作者、年份、标签、项目类型等进行全文搜索和过滤
集合管理: 浏览、搜索并从特定集合中检索项目
标签搜索系统: 强大的标签查询（any、all、none模式）和匹配选项（exact、contains、startsWith）
PDF 处理: 从 PDF 附件中提取全文，并具有页面特定访问权限
注释检索: 从 PDF 中提取高亮、笔记和注释
客户端配置生成器: 自动为各种 AI 客户端生成配置
安全性: 仅限本地操作，确保完全的数据隐私
用户友好: 通过 Zotero 偏好设置界面轻松配置

📸 屏幕截图

这里是一些展示 Zotero MCP 功能的屏幕截图：

功能	屏幕截图
功能演示
文献检索
查看元数据
全文读取 1
全文读取 2
搜索附件 (Gemini CLI)
阅读 PDF (Gemini CLI)

🔧 API 参考

内置的 MCP 服务器提供以下工具：

`search_library`

搜索 Zotero 库。支持参数如 q、title、creator、year、tag、itemType、limit、sort 等。

`get_item_details`

检索单个项目的全部信息。

itemKey (字符串，必需): 项目的唯一键。

`find_item_by_identifier`

通过 DOI 或 ISBN 查找项目。

doi (字符串，可选)
isbn (字符串，可选)

至少需要一个标识符。

🤝 贡献

欢迎贡献！请随意提交拉取请求、报告问题或提出改进意见。

分叉仓库。
创建您的功能分支 (git checkout -b feature/AmazingFeature)。
提交您的更改 (git commit -m '添加一些 AmazingFeature')。
推送到分支 (git push origin feature/AmazingFeature)。
打开拉取请求。

📄 许可证

本项目根据 MIT 许可证授权。

🙏 致谢

Zotero - 一款优秀的开源参考管理工具。
模型上下文协议 - AI 工具集成的协议。
联系我们