Zotero MCP：您在克劳德的研究图书馆

Zotero MCP通过模型上下文协议 (MCP)将您的Zotero研究库与Claude及其他 AI 助手（ Cherry Studio 、 Cursor等）无缝连接。您可以讨论论文、获取摘要、分析引文、提取 PDF 注释等等！

✨ 特点

🔍 搜索你的图书馆

按标题、作者或内容查找论文、文章和书籍
使用多个条件执行复杂搜索
浏览收藏集、标签和最近添加的内容

📚 访问您的内容

检索任何项目的详细元数据
获取全文内容（如有）
访问附件、注释和子项目

📝 使用注释

直接提取和搜索 PDF 注释
访问 Zotero 的原生注释
创建和更新注释和注解

🌐 灵活的访问方式

离线访问的本地方法（无需 API 密钥）
用于云图书馆访问的 Web API
非常适合本地研究和远程协作

Related MCP server: Zotero MCP Server

🚀 快速安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Zotero MCP：

npx -y @smithery/cli install @54yyyu/zotero-mcp --client claude

手动安装

通过 uv 安装

uv tool install "git+https://github.com/54yyyu/zotero-mcp.git"
zotero-mcp setup  # Auto-configure for Claude Desktop

通过 pip 安装

pip install git+https://github.com/54yyyu/zotero-mcp.git
zotero-mcp setup  # Auto-configure for Claude Desktop

🖥️ 设置和使用

完整文档可在Zotero MCP 文档中找到。

要求

Python 3.10+
Zotero 7+（用于具有全文访问的本地 API）
Claude Desktop 或兼容的 AI 助手

对于克劳德桌面

配置

安装后，可以执行以下操作之一：

自动配置（推荐）：
```
zotero-mcp setup
```

手动配置：添加到您的claude_desktop_config.json ：

{
  "mcpServers": {
    "zotero": {
      "command": "zotero-mcp",
      "env": {
        "ZOTERO_LOCAL": "true"
      }
    }
  }
}

用法

启动 Zotero 桌面（确保在首选项中启用了本地 API）
启动 Claude Desktop
通过 Claude Desktop 的工具界面访问 Zotero-MCP 工具

提示示例：

“在我的图书馆中搜索有关机器学习的论文”
“查找我最近添加的有关气候变化的文章”
“总结我关于量子计算的论文的主要发现”
“从我的神经网络论文中提取所有 PDF 注释”
“在我的笔记和注释中搜索‘强化学习’”

对于 Cherry Studio

配置

前往“设置”->“MCP 服务器”->“编辑 MCP 配置”，添加以下内容：

{
  "mcpServers": {
    "zotero": {
      "name": "zotero",
      "type": "stdio",
      "isActive": true,
      "command": "zotero-mcp",
      "args": [],
      "env": {
        "ZOTERO_LOCAL": "true"
      }
    }
  }
}

然后点击“保存”。

Cherry Studio 还提供了常规设置和工具选择的可视化配置方法。

🔧 高级配置

使用 Web API 代替本地 API

通过 Web API 访问您的 Zotero 库（对于远程设置有用）：

zotero-mcp setup --no-local --api-key YOUR_API_KEY --library-id YOUR_LIBRARY_ID

环境变量

ZOTERO_LOCAL=true ：使用本地 Zotero API（默认值：false）
ZOTERO_API_KEY ：您的 Zotero API 密钥（用于 Web API）
ZOTERO_LIBRARY_ID ：您的 Zotero 库 ID（用于 Web API）
ZOTERO_LIBRARY_TYPE ：库的类型（用户或组，默认：用户）

命令行选项

# Run the server directly
zotero-mcp serve

# Specify transport method
zotero-mcp serve --transport stdio|sse

# Get help on setup options
zotero-mcp setup --help

📑 PDF 注释提取

Zotero MCP 包含高级 PDF 注释提取功能：

直接 PDF 处理：直接从 PDF 文件中提取注释，即使它们尚未被 Zotero 索引
增强搜索：搜索 PDF 注释和评论
图像注释支持：从 PDF 中提取图像注释
无缝集成：与 Zotero 的原生注释系统协同工作

为了获得最佳的注释提取效果，强烈建议安装 Zotero 的Better BibTeX 插件。注释相关的功能已通过此插件初步测试，并将在插件可用时提供增强功能。

第一次使用PDF注释功能时，必要的工具将自动下载。

📚 可用工具

搜索工具

zotero_search_items ：搜索你的图书馆
zotero_advanced_search ：执行复杂的搜索
zotero_get_collections ：列出集合
zotero_get_collection_items ：获取集合中的项目
zotero_get_tags ：列出所有标签
zotero_get_recent ：获取最近添加的项目

内容工具

zotero_get_item_metadata ：获取详细元数据
zotero_get_item_fulltext ：获取全文内容
zotero_get_item_children ：获取附件和注释

注释和笔记工具

zotero_get_annotations ：获取注释（包括直接 PDF 提取）
zotero_get_notes ：从 Zotero 库中检索笔记
zotero_search_notes ：在笔记和注释中搜索（包括 PDF 提取）
zotero_create_note ：为项目创建新注释（测试版功能）

🔍 故障排除

未找到结果：确保 Zotero 正在运行并且本地 API 已启用
无法连接到库：如果使用 Web API，请检查您的 API 密钥和库 ID
全文不可用：请确保您使用 Zotero 7+ 进行本地全文访问

📄 许可证

麻省理工学院

Install Server

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Tools

View all tools

Zotero MCP