金大哥 - zotero-mcp MCP 详情

article

README

🚀 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：为特定文献创建新的批注。

📚 详细文档

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

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

📄 许可证

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

zotero-mcp