项目简介

该项目是一个 MCP (Model Context Protocol) 服务器,用于将 Zotero 文献管理工具与大型语言模型 (LLM) 应用连接起来。通过该服务器,LLM 可以访问和操作用户的 Zotero 文献库,实现文献检索、信息获取等功能。

主要功能点

  • 检索 Zotero 文献库: 允许 LLM 搜索用户的 Zotero 文献库,查找相关文献。
  • 获取文献信息: 提供工具获取 Zotero 文献库中 Collection 列表、Collection 中的条目、以及特定条目的详细信息。
  • 获取最近添加的文献: 可以获取用户最近添加到 Zotero 文献库的文献列表。
  • 作为 MCP 服务器运行: 遵循 Model Context Protocol 协议,可以与任何兼容 MCP 协议的客户端(如 Claude Desktop)进行通信。

安装步骤

  1. 获取 Zotero API 密钥和用户 ID:
    • 访问 Zotero 设置 创建一个新的 API 密钥。
    • 使用 'curl' 命令和 API 密钥获取用户 ID,按照 README.md 中的步骤操作。
  2. 设置环境变量:
    • 设置 'ZOTERO_API_KEY' 和 'ZOTERO_USER_ID' 环境变量,分别设置为你的 API 密钥和用户 ID。
  3. 安装 MCP Zotero 服务器:
    • 确保已安装 Node.js 和 npm。
    • 全局安装 'mcp-zotero' 包: 'npm install -g mcp-zotero'

服务器配置

要将此 MCP 服务器与 MCP 客户端(例如 Claude Desktop)集成,您需要配置客户端以连接到此服务器。以下是一个 Claude Desktop 的配置示例,展示了如何配置 'zotero' 服务器:

{
  "mcpServers": {
    "zotero": {
      "command": "mcp-zotero",
      "env": {
        "ZOTERO_API_KEY": "YOUR_ZOTERO_API_KEY", // 替换为你的 Zotero API 密钥
        "ZOTERO_USER_ID": "YOUR_ZOTERO_USER_ID"   // 替换为你的 Zotero 用户 ID
      }
    }
  }
}
  • 'server name': 'zotero' (服务器名称,客户端用以标识)
  • 'command': 'mcp-zotero' (启动 MCP 服务器的命令)
  • 'env': 环境变量配置
    • 'ZOTERO_API_KEY': [必须] 你的 Zotero API 密钥。
    • 'ZOTERO_USER_ID': [必须] 你的 Zotero 用户 ID。

基本使用方法

  1. 启动 MCP Zotero 服务器:在终端中运行 'mcp-zotero' 命令。
  2. 配置 MCP 客户端(如 Claude Desktop)连接到 'zotero' 服务器。
  3. 在 MCP 客户端中,可以使用预定义的工具(例如 'get_collections', 'search_library' 等)与 Zotero 文献库进行交互。具体的工具列表和使用方法请参考仓库的 README.md 文件或服务器返回的工具列表。

信息

分类

生产力应用