适合谁
- 研究人员、学生和学者，希望将 Zotero 文献库与 AI 助手集成。
- 需要快速从文献库中检索、总结和注释的用户。
- 希望通过语义搜索发现相关研究的用户。
- 需要自动化文献管理（如批量添加、去重）的用户。
Z
69FMRS · C
Zotero MCP 是一个功能丰富的服务器，将 Zotero 文献库无缝集成到 AI 助手中。它提供搜索、语义搜索、批注提取、文献添加和去重等核心功能，并支持可选的 scite 和语义搜索扩展。安装和配置较为简单，通过官方文档和 CLI 工具可快速上手。主要风险在于 API 密钥管理和外部服务依赖，用户需谨慎设置权限。总体而言，它非常适合研究人员和学生使用。
Zotero MCP 通过模型上下文协议 (MCP) 将您的 Zotero 文献库与 AI 助手连接起来。它支持本地和云端访问，提供智能语义搜索（需额外安装），可检索论文、获取摘要、分析引用、提取 PDF 注释，并支持添加和管理文献、集合等。该服务器需要启用 Zotero 本地 API（Zotero 7+）或配置 Web API 密钥，并可根据需要启用可选工具集（如 scite、duplicates 等）。
工具能力
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
列出所有标签。
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
移除相关条目关系。
安装接入
- 安装 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"
}
}
}
}
选型与风险
不适合谁
- 不需要 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）会调用外部服务，可能产生网络请求。
常见排障
- 无搜索结果：确保 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、URL 或本地文件快速添加文献。
查找和合并重复条目，管理文献库。
通过 scite 智能获取引用支持和撤稿提醒（可选）。
支持客户端
Claude Desktop完整支持
Claude Code完整支持
ChatGPT完整支持
Cherry Studio完整支持