Zotero MCP

社区

将您的 Zotero 文献库连接到 Claude、ChatGPT 等 AI 助手，进行检索、阅读、注释和添加。

分类: 其他第 16 / 230
Stars: ★ 5.5k 非常热门
传输方式: stdio（本地进程）
运行环境: Python 3.10+ · Docker
凭据: 可选 API Key
许可证: MIT
最近提交: 5 天前
工具数: 37

69FMRS · C

Zotero MCP 是一个功能丰富的服务器，将 Zotero 文献库无缝集成到 AI 助手中。它提供搜索、语义搜索、批注提取、文献添加和去重等核心功能，并支持可选的 scite 和语义搜索扩展。安装和配置较为简单，通过官方文档和 CLI 工具可快速上手。主要风险在于 API 密钥管理和外部服务依赖，用户需谨慎设置权限。总体而言，它非常适合研究人员和学生使用。

最强项 · 文档质量 16/20 最弱项 · 可靠性 11/20

可靠性

11/20

安全与权限

13/20

维护活跃度

15/20

文档质量

16/20

安装易用性

14/20

查看各项评分依据

可靠性 11/20: 证据：server.json 声明了明确的 stdio 启动命令（zotero-mcp-server serve）、版本 0.9.1、包存在；README 展示的工具按工具组划分且有 ZOTERO_MCP_TOOLSETS 开关；仓库含 CI 与测试（README 提到 294 个 pytest），源码目录有 tests/ 及 .github/workflows，且项目标为未归档。扣分：本评审只读源码，未实际执行，无法验证 init/tool-list 握手与全部工具行为；README/清单属不可信证据，工具与真实实现的对应只能部分由源码佐证；测试数量与覆盖核心路径的程度未在清单中直接可见。
安全与权限 13/20: 证据：API key 通过环境变量传入，清单将 ZOTERO_API_KEY 标记为 isSecret；本地模式默认开启，避免不必要地上传云端；写操作为混合模式需显式提供凭据；工具组默认关闭可选面，降低暴露面；无证据显示恶意行为、真实令牌示例或不可逆删除默认值。扣分：未看到代码级凭据处理/日志脱敏细节；危险写操作（合并、删除类）的确认机制未在清单或 README 中明确；外部网络调用（scite、WebDAV、嵌入 API）的作用域与数据流披露不够完整。
维护活跃度 15/20: 证据：仓库活跃、未归档，版本 0.9.1，README 有更新命令与版本说明；MIT 许可证存在；PyPI 包发布；提交/发布节奏与问题响应无法从静态资料确认。扣分：未提供安全响应渠道或依赖更新策略的可见证据；问题关闭率、维护者响应时间等无法核实。
文档质量 16/20: 证据：README 分层覆盖快速安装、可选 extras、语义搜索、环境变量、CLI、Docker、工具列表、故障排查、测试计划；客户端配置示例（Claude、Cherry Studio、Autohand）明确；文档网站链接存在；工具参数与限制（工具组、token 成本、pdf_max_pages 等）有说明。扣分：部分高级功能（如 OpenAI Batch）依赖外部服务细节，成本/限流说明有限；troubleshooting 为自述性质，缺少可复核的日志级证据。
安装易用性 14/20: 证据：提供 uv/pip/pipx 安装、自动配置命令 zotero-mcp setup、Claude 与 Cherry Studio 的 JSON 配置示例、Docker 镜像、CLI 自检命令与本地/混合/Web 模式说明；local API 开关有截图引用。扣分：静态评审，未执行安装流程；对 GUI 客户端找不到命令的情形虽提供绝对路径提示，但跨平台（Windows/WSL/macOS）安装细节与失败恢复未完全展开。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络连接数据库

适合谁

研究人员、学生和学者，希望将 Zotero 文献库与 AI 助手集成。
需要快速从文献库中检索、总结和注释的用户。
希望通过语义搜索发现相关研究的用户。
需要自动化文献管理（如批量添加、去重）的用户。

不适合谁

不需要 AI 助手集成，仅想从终端管理 Zotero 的用户（可使用 zotero-cli）。
不使用 Zotero 的用户。
需要完全离线且不依赖本地 Zotero 应用的用户（Web API 模式仍需网络）。

所需权限

读取本地 Zotero 数据库文件（默认路径）。
在混合模式下通过 Zotero Web API 写入（添加、更新、删除条目）。
访问 Zotero 附件文件（如 PDF）以提取全文和批注。
当启用语义搜索时，调用嵌入模型 API（如 OpenAI、Gemini）并存储索引数据。
当启用 scite 工具时，调用 scite.ai 公共 API。

风险与副作用

AI 助手可能会误读或误解文献数据，重要信息需人工核对。
设置为 Web API 模式需要提供 Zotero API 密钥，若泄露可能导致您的文献库被未授权访问。
语义搜索索引可能包含敏感内容，存储的嵌入数据需妥善保护。
启用的可选工具集（如 scite）会调用外部服务，可能产生网络请求。

安装接入

准备工作

运行环境：Python 3.10+ · Docker

ZOTERO_API_KEY 可选密钥 Zotero Web API 密钥，在 https://www.zotero.org/settings/keys 生成，本地模式为 false 或混合模式写操作时需要。

OPENAI_API_KEY 可选密钥 OpenAI API 密钥，选择 OpenAI 嵌入模型时需要，在 platform.openai.com 获取。

GEMINI_API_KEY 可选密钥 Google Gemini API 密钥，选择 Gemini 嵌入模型时需要。

ZOTERO_WEBDAV_PASSWORD 可选密钥 WebDAV 密码，可选。

其他可选配置项（18 个）

ZOTERO_LOCAL 可选设为 true 时读取本地 Zotero 桌面应用，需 Zotero 7+ 并在设置中启用本地 API。

ZOTERO_LIBRARY_ID 可选 Zotero 用户或群组库 ID，同一密钥页面可查看个人 userID。

ZOTERO_LIBRARY_TYPE 可选指定库类型是个人（user）还是群组（group），默认 user。

ZOTERO_MCP_TOOLSETS 可选逗号分隔的可选工具组开关（all/none/组名），控制暴露哪些工具组。

ZOTERO_EMBEDDING_MODEL 可选语义搜索使用的嵌入模型类型：default、openai、gemini 或 ollama。

OPENAI_EMBEDDING_MODEL 可选 OpenAI 嵌入模型名，如 text-embedding-3-small 或 text-embedding-3-large。

OPENAI_BASE_URL 可选自定义 OpenAI 兼容端点 URL，可选。

GEMINI_EMBEDDING_MODEL 可选 Gemini 嵌入模型名，如 gemini-embedding-001。

GEMINI_BASE_URL 可选自定义 Gemini 兼容端点 URL，可选。

OLLAMA_EMBEDDING_MODEL 可选通过本地 Ollama 运行嵌入时的模型名，默认 qwen3-embedding。

OLLAMA_BASE_URL 可选 Ollama 服务器地址，默认 http://localhost:11434。

ZOTERO_DB_PATH 可选自定义 zotero.sqlite 路径，不设置时自动定位。

ZOTERO_WEBDAV_URL 可选可选的 WebDAV 目录 URL，用于远程模式直接下载附件。

ZOTERO_WEBDAV_USERNAME 可选 WebDAV 用户名，可选。

ZOTERO_MCP_SCHEMA_REFRESH 可选设为 0 可禁用每周后台刷新 Zotero 条目类型 schema。

ZOTERO_MCP_SCHEMA_CACHE 可选自定义 schema 缓存路径，默认 ~/.cache/zotero-mcp/schema.。

ZOTERO_APP 可选 Docker 容器运行模式：server（默认）或 cli。

ZOTERO_TRANSPORT 可选 Docker 容器中的传输方式，默认 stdio。

安装 Python 3.10+ 和 Zotero 7+。
使用 uv、pip 或 pipx 安装 zotero-mcp-server（基础版包含核心工具，可选 extras 如 [semantic]、[pdf]、[scite]）。
运行 zotero-mcp setup 自动配置（支持 Claude Desktop），或手动在 MCP 客户端配置文件中添加如文档所示的 JSON。
确保在 Zotero 设置中启用本地 API（设置 -> 高级）。
重启 MCP 客户端并验证连接。

claude_desktop_config.json

{
  "mcpServers": {
    "zotero": {
      "command": "zotero-mcp",
      "env": {
        "ZOTERO_LOCAL": "true",
        "ZOTERO_API_KEY": "YOUR_API_KEY",
        "ZOTERO_LIBRARY_ID": "YOUR_LIBRARY_ID"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "zotero": {
      "command": "zotero-mcp",
      "env": {
        "ZOTERO_LOCAL": "true",
        "ZOTERO_API_KEY": "YOUR_API_KEY",
        "ZOTERO_LIBRARY_ID": "YOUR_LIBRARY_ID"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add zotero -e ZOTERO_LOCAL=true -e ZOTERO_API_KEY=YOUR_API_KEY -e ZOTERO_LIBRARY_ID=YOUR_LIBRARY_ID -- zotero-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

运行 zotero-mcp setup 完成配置后，在 Claude Desktop 或 Claude Code 的工具列表中应能看到 zotero_search_items、zotero_get_item_metadata 等 zotero_ 开头的工具；用 "Search my library for papers on machine learning" 这类提示词得到检索结果即证明连接成功。

常见排障

无搜索结果：确保 Zotero 正在运行且已启用本地 API（设置 -> 高级）。
连接失败：检查 API 密钥和库 ID 是否配置正确（Web API 模式）。
全文不可用：确保使用 Zotero 7+。
语义搜索错误：运行 `zotero-mcp update-db --force-rebuild` 重建索引，或删除 `~/.config/zotero-mcp/chroma_db/` 后重建。
工具不可用：检查 ZOTERO_MCP_TOOLSETS 设置，确保所需工具组已启用。
CLI 找不到命令：使用绝对路径或运行 `zotero-mcp setup-info` 获取路径。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

在我的文献库中搜索关于机器学习的论文
提取我那篇关于神经网络的论文的全部 PDF 批注
用 DOI 10.1038/s41586-021-03819-2 把这篇论文添加到 Reading List 收藏夹
查找与我库里这篇论文概念上相似的深度学习论文（语义搜索）

工具能力 37

zotero_semantic_search 只读

基于嵌入模型的相似性搜索，理解概念而非仅关键词。

zotero_update_search_database 写入

手动更新语义搜索数据库。

zotero_get_search_database_status 只读

检查语义搜索数据库的状态和配置。

zotero_search_items 只读

按关键词搜索您的文献库。

zotero_advanced_search 只读

使用多条件进行复杂搜索。

zotero_get_collections 只读

列出所有集合。

zotero_get_collection_items 只读

获取集合中的条目。

zotero_get_tags 只读

列出所有标签。

展开其余 29 个工具

zotero_get_recent 只读

获取最近添加的条目。

zotero_search_by_tag 只读

使用自定义标签筛选搜索。

zotero_get_item_metadata 只读

获取条目的详细元数据（支持 markdown、json、bibtex 格式）。

zotero_get_item_fulltext 只读

获取条目的全文内容。

zotero_get_item_children 只读

获取条目的附件和笔记。

zotero_get_annotations 只读

获取批注（可提取 PDF 中的批注，支持 json 格式）。

zotero_synthesize_annotations 只读

构建每篇论文的批注/笔记摘要。

zotero_get_notes 只读

获取笔记，可通过 query 搜索笔记和批注文本。

zotero_create_annotation 写入

创建高亮或区域批注。

zotero_manage_note 写入

创建、更新或删除笔记。

zotero_get_page_layout 只读

检测 PDF 页面的图表区域和坐标，用于精确定位批注。

zotero_add_by_doi 写入

通过 DOI 添加论文，自动获取元数据和开放获取 PDF。

zotero_add_by_url 写入

通过 URL 添加论文（arXiv、DOI 链接、网页等）。

zotero_add_by_isbn 写入

通过 ISBN 添加图书。

zotero_add_by_bibtex 写入

从 BibTeX 添加一条或多条条目。

zotero_add_by_csl_json

从 CSL JSON 添加一条或多条条目。

zotero_add_from_file 写入

从本地 PDF 或 EPUB 文件导入，自动提取 DOI。

zotero_attach_file 写入

将本地文件或 PDF URL 附加到现有条目。

zotero_create_collection 写入

创建新的集合。

zotero_search_collections 只读

按名称搜索集合以获取其密钥。

zotero_manage_collections 写入

添加或移除集合中的条目。

zotero_update_item 写入

更新现有条目的元数据（标题、标签、摘要等）。

zotero_find_duplicates 只读

按标题和/或 DOI 查找重复条目。

zotero_merge_duplicates 破坏性

合并重复条目，支持预览。

zotero_get_pdf_outline 只读

提取 PDF 附件的目录/大纲。

zotero_search_by_citation_key 只读

通过 BetterBibTeX 引用键查找条目。

zotero_get_item_related 只读

获取条目的相关条目。

zotero_add_item_relation 写入

添加相关条目关系（双向链接）。

zotero_remove_item_relation 破坏性

移除相关条目关系。

使用场景

在 AI 助手中搜索文献库中的论文、获取摘要和元数据。

使用语义搜索查找概念相似的论文。

提取 PDF 批注和笔记，进行文献综述。

通过 DOI、URL 或本地文件快速添加文献。

查找和合并重复条目，管理文献库。

通过 scite 智能获取引用支持和撤稿提醒（可选）。

支持客户端

Claude Desktop

Claude Code

ChatGPT

Cherry Studio

依据项目文档列出，未经本站实测。

详细介绍

Zotero MCP 通过模型上下文协议 (MCP) 将您的 Zotero 文献库与 AI 助手连接起来。它支持本地和云端访问，提供智能语义搜索（需额外安装），可检索论文、获取摘要、分析引用、提取 PDF 注释，并支持添加和管理文献、集合等。该服务器需要启用 Zotero 本地 API（Zotero 7+）或配置 Web API 密钥，并可根据需要启用可选工具集（如 scite、duplicates 等）。