🚀 Zotero MCP：您的研究资料室Claude
Zotero MCP是一款强大的工具，它将Zotero与Claude等人工智能助手相连接，让您能够借助MCP协议轻松访问和管理研究资料，极大提升研究效率。
🚀 快速开始
Zotero MCP作为连接Zotero与人工智能助手的工具，通过MCP协议为您提供便捷的研究资料访问与管理体验。
✨ 主要特性
搜索功能
- 搜索资料室：可快速查找文献资源。
- 高级搜索：支持复杂查询条件，精准定位所需内容。
- 收藏夹管理：能列出并查看所有收藏夹及其包含的文献。
- 最近更新：可获取最近添加到资料室的文献。
内容访问
- 元数据检索：能获取文献的详细信息，如标题、作者和出版年份。
- 全文获取：在支持的情况下，可直接阅读文献的全文内容。
- 附件管理：可查看与文献相关联的所有附件和笔记。
注释与笔记处理
- 注释提取：可从PDF文件中直接提取手写或文本注释。
- 笔记检索：能快速访问在Zotero中添加的所有笔记。
- 内容搜索：可在笔记和注释中进行全文搜索，包括从PDF中提取的内容。
- 新建笔记：可为特定文献创建新的批注（测试功能）。
灵活的接入方式
- 本地API使用：可通过Zotero的本地服务访问资料室。
- Web API对接：支持远程服务器上的资料室访问，需提供相应的API密钥和资料室ID。
📦 安装指南
使用Smithery安装
# 直接安装并启动服务
zotero-mcp setup
手动安装（uv方式）
- 下载源代码：从项目仓库克隆或下载。
- 运行安装脚本：
uv zotero-mcp run - 启动服务：
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_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：为特定文献创建新的批注。
📚 详细文档
如遇问题，请访问项目官网或加入用户社区寻求帮助：
📄 许可证
本项目遵循MIT开源协议，具体条款请参考项目的LICENSE文件。