Zotero MCP

by 54yyyu
Verified

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Connects to your Zotero research library, allowing you to search for papers, articles and books, retrieve metadata, access full-text content, and browse collections, tags, and recent additions.

Zotero MCP:您在克劳德的研究图书馆

Zotero MCP通过模型上下文协议 (MCP)将您的Zotero研究库与Claude及其他 AI 助手无缝连接。讨论论文、获取摘要、分析引文等等!

🚀 快速安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Zotero MCP:

npx -y @smithery/cli install @54yyyu/zotero-mcp --client claude

通过 pip 安装

pip install git+https://github.com/54yyyu/zotero-mcp.git zotero-mcp setup # Auto-configure for Claude Desktop

✨ 特点

搜索你的图书馆

  • 按标题、作者或内容查找论文、文章和书籍
  • 使用多个条件执行复杂搜索
  • 浏览收藏集、标签和最近添加的内容

访问您的内容

  • 检索任何项目的详细元数据
  • 获取全文内容(如有)
  • 访问附件、注释和子项目

🖥️ 设置和使用

对于克劳德桌面

安装后,可以执行以下操作之一:

  1. 自动配置(推荐):
    zotero-mcp setup
  2. 手动配置:添加到您的claude_desktop_config.json
    { "mcpServers": { "zotero": { "command": "zotero-mcp", "env": { "ZOTERO_LOCAL": "true" } } } }

要求

  • Python 3.10+
  • Zotero 7+(用于具有全文访问的本地 API)
  • Claude Desktop 或兼容的 AI 助手

在 Claude 中使用 Zotero

  1. 启动 Zotero 桌面(确保在首选项中启用了本地 API)
  2. 启动 Claude Desktop
  3. 通过 Claude Desktop 的工具界面访问 Zotero-MCP 工具

提示示例:

  • “在我的图书馆中搜索有关机器学习的论文”
  • “查找我最近添加的有关气候变化的文章”
  • “总结我关于量子计算的论文的主要发现”

🔧 高级配置

使用 Web API 代替本地 API

通过 Web API 访问您的 Zotero 库(对于远程设置有用):

zotero-mcp setup --no-local --api-key YOUR_API_KEY --library-id YOUR_LIBRARY_ID

环境变量

  • ZOTERO_LOCAL=true :使用本地 Zotero API(默认值:false)
  • ZOTERO_API_KEY :您的 Zotero API 密钥(用于 Web API)
  • ZOTERO_LIBRARY_ID :您的 Zotero 库 ID(用于 Web API)
  • ZOTERO_LIBRARY_TYPE :库的类型(用户或组,默认:用户)

命令行选项

# Run the server directly zotero-mcp serve # Specify transport method zotero-mcp serve --transport stdio|sse # Get help on setup options zotero-mcp setup --help

📚 可用工具

搜索工具

  • zotero_search_items :搜索你的图书馆
  • zotero_advanced_search :执行复杂的搜索
  • zotero_get_collections :列出集合
  • zotero_get_collection_items :获取集合中的项目
  • zotero_get_tags :列出所有标签
  • zotero_get_recent :获取最近添加的项目

内容工具

  • zotero_get_item_metadata :获取详细元数据
  • zotero_get_item_fulltext :获取全文内容
  • zotero_get_item_children :获取附件和注释

🔍 故障排除

  • 未找到结果:确保 Zotero 正在运行并且本地 API 已启用
  • 无法连接到库:如果使用 Web API,请检查您的 API 密钥和库 ID
  • 全文不可用:请确保您使用 Zotero 7+ 进行本地全文访问

📄 许可证

麻省理工学院

ID: yfe03znm4t