mcpField
M
MCP Zotero

MCP Zotero

本地服务
github.com/kaliaboi科研与教育16390 周前更新
代码仓库

关于 MCP Zotero

MCP Zotero 是用于 Claude Desktop 的 Zotero 连接器，通过 Zotero Cloud API 访问用户的文献库、文件夹和条目。适合希望在对话中查询和检索文献的研究人员。

主要功能

  1. 01列出文献库中的所有文件夹
  2. 02查看指定文件夹中的条目
  3. 03获取单篇文献的详细信息
  4. 04检索整个文献库
  5. 05列出最近添加的文献

适用场景

  1. 01在 Claude Desktop 中查找已保存的文献
  2. 02查看某个文件夹中的论文列表
  3. 03检索近期添加到文库的文献

MCP 相关

该项目是 MCP 服务，向 Claude Desktop 等 MCP 客户端提供 5 个工具，用于读取 Zotero 文献库的文件夹、条目和搜索结果。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "zotero": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-zotero"
      ]
    }
  }
}
启动命令npx -y mcp-zotero

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmmcp-zotero

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

MCP Zotero

NPM Version smithery badge

用于集成 Zotero 的模型上下文协议服务，可让 Claude 与你的 Zotero 文库交互。

Zotero MCP 服务

设置

  1. 获取你的 Zotero 凭据：

    # First, create an API key at https://www.zotero.org/settings/keys
# Then use it to get your user ID:
curl -H "Zotero-API-Key: YOUR_API_KEY" https://api.zotero.org/keys/current

    响应内容如下所示：

    {
  "userID": 123456,
  "username": "your_username",
  "access": {
    "user": {
      "library": true,
      "files": true,
      "notes": true,
      "write": true
    }
  }
}

    你需要的是 userID 的值。

  2. 设置环境变量：

    export ZOTERO_API_KEY="your-api-key"
export ZOTERO_USER_ID="user-id-from-curl"

  3. 验证你的凭据：

    # Test that your credentials work:
curl -H "Zotero-API-Key: $ZOTERO_API_KEY" \
     "https://api.zotero.org/users/$ZOTERO_USER_ID/collections"

    你应该会在响应中看到文集列表。

  4. 安装并运行：

    # Install globally (recommended)
npm install -g mcp-zotero
mcp-zotero

# Or run directly with npx
npx mcp-zotero

与 Claude Desktop 集成

要在 Claude Desktop 中使用此服务，请将以下内容添加到 Claude Desktop 配置中：

{
  "mcpServers": {
    "zotero": {
      "command": "mcp-zotero",
      "env": {
        "ZOTERO_API_KEY": YOUR_API_KEY,
        "ZOTERO_USER_ID": YOUR_USER_ID
      }
    }
  }
}

可用工具

  • get_collections：列出文库中的所有文集
  • get_collection_items：获取指定文集中的条目
  • get_item_details：获取论文的详细信息
  • search_library：搜索整个文库
  • get_recent：获取最近添加的论文

故障排除

如果遇到问题：

  1. 确认已设置环境变量：

    echo $ZOTERO_API_KEY
echo $ZOTERO_USER_ID

  2. 检查安装情况：

    npm list -g mcp-zotero

  3. 尝试重新安装：

    npm uninstall -g mcp-zotero
npm install -g mcp-zotero

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。