🚀 Zotero MCP：您的研究资料室Claude

Zotero MCP是一款强大的工具，它能将Zotero与Claude等人工智能助手连接起来。借助MCP协议，用户可以轻松访问和管理自己的研究资料，极大提升研究效率。

🚀 快速开始

Zotero MCP是一个将Zotero与Claude等人工智能助手连接起来的工具，使您能够通过MCP协议访问和管理您的研究资料。

✨ 主要特性

搜索功能

• 搜索资料室：可快速查找您的文献资源。
• 高级搜索：支持复杂查询条件，助力您精准定位所需内容。
• 收藏夹管理：能列出并查看所有收藏夹及其包含的文献。
• 最近更新：可获取最近添加到资料室的文献。

内容访问

• 元数据检索：能获取文献的详细信息，如标题、作者和出版年份。
• 全文获取：在支持的情况下，可直接阅读文献的全文内容。
• 附件管理：可查看与文献相关联的所有附件和笔记。

注释与笔记处理

• 注释提取：可从PDF文件中直接提取手写或文本注释。
• 笔记检索：能快速访问您在Zotero中添加的所有笔记。
• 内容搜索：可在笔记和注释中进行全文搜索，包括从PDF中提取的内容。
• 新建笔记：可为特定文献创建新的批注（测试功能）。

灵活的接入方式

• 本地API使用：可通过Zotero的本地服务访问资料室。
• Web API对接：支持远程服务器上的资料室访问，需提供相应的API密钥和资料室ID。

📦 安装指南

使用Smithery安装

# 直接安装并启动服务
zotero-mcp setup

手动安装（uv方式）

1. 下载源代码：从项目仓库克隆或下载。
2. 运行安装脚本：

   uv zotero-mcp run
   

3. 启动服务：

   zotero-mcp serve
   

通过pip安装

pip install zotero-mcp

🔧 技术细节

高级配置

使用Web API代替本地API

zotero-mcp setup --no-local --api-key 您的API密钥 --library-id 您的资料室ID

环境变量

• ZOTERO_LOCAL=true：使用本地Zotero服务（默认为false）。
• ZOTERO_API_KEY：您的Zotero Web API密钥。
• ZOTERO_LIBRARY_ID：您要访问的资料室ID。
• ZOTERO_LIBRARY_TYPE：资料室类型，可选值为user或group（默认为user）。

命令行选项

# 直接运行服务
zotero-mcp serve

# 指定传输方式
zotero-mcp serve --transport stdio|sse

# 获取更多设置帮助
zotero-mcp setup --help

PDF注释提取功能

Zotero MCP提供了强大的PDF注释处理能力，包括：

• 直接PDF解析：无需依赖Zotero的索引功能，即可提取PDF中的手写和文本注释。
• 增强搜索：在注释内容中进行全文搜索。
• 图像注释支持：识别并提取PDF中的图像标注。
• 无缝集成：与Zotero的原生注释系统完美兼容。

推荐：为了获得最佳体验，建议安装Zotero Better BibTeX插件。此功能在插件环境下表现更佳。

💻 使用示例

基础用法

以下是一些常用工具的使用示例：

# 搜索资料室中的文献
zotero_search_items()

# 获取文献的详细元数据
zotero_get_metadata()

高级用法

# 执行高级复杂查询
zotero_advanced_search("复杂查询条件")

# 从PDF中提取注释内容
zotero_extract_annotations("pdf文件路径")

📚 详细文档

可用工具集

搜索类工具

• zotero_search_items：搜索资料室中的文献。
• zotero_advanced_search：执行高级复杂查询。
• zotero_get_collections：获取所有收藏夹列表。
• zotero_get_collection_items：查看特定收藏夹中的文献。
• zotero_get_tags：列出所有标签。
• zotero_get_recent：获取最近添加的文献。

内容访问工具

• zotero_get_metadata：获取文献的详细元数据。
• zotero_get_fulltext：在支持的情况下，获取文献全文内容。
• zotero_list_attachments：查看与文献相关的附件列表。

注释处理工具

• zotero_extract_annotations：从PDF中提取注释内容。
• zotero_search_notes：在所有笔记和注释中进行全文搜索。
• zotero_create_note：为特定文献创建新的批注。

🛠️ 故障排除与支持

如遇问题，请访问项目官网或加入用户社区寻求帮助：

• 项目主页：https://github.com/yourusername/zotero-mcp
• 用户论坛：https://discussions.zotero.org

📄 许可证

本项目遵循MIT开源协议，具体条款请参考项目的LICENSE文件。