关键词

Zotero文献管理学术研究知识库论文助手

使用说明

项目简介

Zotero MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在将您的 Zotero 文献管理库无缝连接到 Claude、Cherry Studio、Cursor 等支持 MCP 协议的 LLM 客户端。通过 Zotero MCP 服务器，您可以利用 LLM 客户端直接访问和操作您的 Zotero 文献库，实现文献检索、内容获取、注释提取等功能，从而更高效地进行学术研究和知识管理。

主要功能点

  • 文献检索: 通过关键词、作者、标题等信息快速检索 Zotero 文献库中的论文、书籍、文章等资源。支持多种检索模式和高级搜索条件。
  • 内容访问: 获取 Zotero 条目的详细元数据信息，包括标题、作者、摘要、出版信息、标签等。支持获取条目的全文内容（如果可用）。
  • 注释处理: 提取和搜索 PDF 文档中的注释，包括高亮、笔记等。支持 Zotero 原生注释和直接从 PDF 文件提取的注释。
  • 灵活访问: 支持本地 API 和 Web API 两种方式连接 Zotero 库，满足不同场景下的使用需求。
  • 工具集成: 提供丰富的工具集，方便 LLM 客户端调用，执行各种 Zotero 相关操作。

安装步骤

方法一：使用 Smithery 自动安装 (推荐 Claude Desktop 用户使用)

  1. 确保您已安装 Smithery 客户端。
  2. 打开终端，运行以下命令，即可自动安装 Zotero MCP 服务器并配置 Claude Desktop 客户端： 
    npx -y @smithery/cli install @54yyyu/zotero-mcp --client claude

方法二：手动安装 (通用方法)

  1. 安装 Python 环境: 确保您的计算机上已安装 Python 3.10 或更高版本。
  2. 安装 Zotero MCP: 选择使用 uv 或 pip 进行安装。
    • 使用 uv 安装: 
      uv tool install "git+https://github.com/54yyyu/zotero-mcp.git"
    • 使用 pip 安装: 
      pip install git+https://github.com/54yyyu/zotero-mcp.git
  3. 配置 Claude Desktop (如果使用): 安装完成后，运行 'zotero-mcp setup' 命令进行自动配置，或参考后续服务器配置部分进行手动配置。

服务器配置

Zotero MCP 服务器主要通过 'zotero-mcp setup' 命令进行配置，可以根据您的需求选择使用本地 Zotero API 或 Web API。

1. Claude Desktop 配置示例

以下 JSON 配置信息添加到 Claude Desktop 的 'claude_desktop_config.json' 文件中，即可将 Zotero MCP 服务器添加到 Claude Desktop 的工具列表中。

{
  "mcpServers": {
    "zotero": {
      "command": "zotero-mcp",
      "env": {
        "ZOTERO_LOCAL": "true"
      }
    }
  }
}

配置参数说明：

  • 'server name': 'zotero' (服务器名称，在 Claude Desktop 中使用 '/tools zotero' 命令时会用到)
  • 'command': 'zotero-mcp' (MCP 服务器的启动命令，确保 Claude Desktop 可以找到该命令，如果 'zotero-mcp' 命令不在环境变量 PATH 中，请使用完整路径)
  • 'env': 环境变量
    • 'ZOTERO_LOCAL': '"true"' 表示使用本地 Zotero API 连接 (需要 Zotero 桌面版运行并启用本地 API)。 如果设置为 '"false"' 或不设置，则默认使用 Web API (需要配置 API Key 和 Library ID)。

2. Cherry Studio 配置示例

以下 JSON 配置信息添加到 Cherry Studio 的 MCP 服务器配置中。

{
  "mcpServers": {
    "zotero": {
      "name": "zotero",
      "type": "stdio",
      "isActive": true,
      "command": "zotero-mcp",
      "args": [],
      "env": {
        "ZOTERO_LOCAL": "true"
      }
    }
  }
}

配置参数说明：

  • 'name': 'zotero' (服务器名称)
  • 'type': '"stdio"' (传输协议，Zotero MCP 服务器默认使用 stdio)
  • 'isActive': 'true' (是否启用该服务器)
  • 'command': 'zotero-mcp' (MCP 服务器的启动命令，与 Claude Desktop 配置相同)
  • 'args': '[]' (启动参数，此处为空)
  • 'env': 环境变量 (与 Claude Desktop 配置相同)

3. Web API 配置 (非本地 Zotero 桌面版)

如果需要使用 Zotero Web API 连接远程 Zotero 库，请在配置时移除或将 'ZOTERO_LOCAL' 设置为 '"false"'，并配置以下环境变量：

  • 'ZOTERO_API_KEY': 您的 Zotero API 密钥 (在 Zotero 网站个人设置中创建)
  • 'ZOTERO_LIBRARY_ID': 您的 Zotero 库 ID (用户库 ID 或群组库 ID)
  • 'ZOTERO_LIBRARY_TYPE': 库类型，'"user"' (用户库) 或 '"group"' (群组库)，默认为 '"user"'

例如，使用 'zotero-mcp setup' 命令配置 Web API 连接：

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

并在客户端配置中移除或注释掉 'ZOTERO_LOCAL: "true"' 这一行。

基本使用方法

  1. 启动 Zotero 桌面版 (如果使用本地 API): 确保 Zotero 桌面应用程序已运行，并已在 Zotero 偏好设置中启用本地 API (默认已启用)。
  2. 启动 LLM 客户端: 启动 Claude Desktop, Cherry Studio, Cursor 等支持 MCP 协议的 LLM 客户端。
  3. 连接 Zotero MCP 服务器: 在 LLM 客户端中配置并启用 Zotero MCP 服务器。具体配置方法请参考各客户端的文档 (如 Claude Desktop 的 'claude_desktop_config.json' 或 Cherry Studio 的 MCP 服务器设置)。
  4. 使用 Zotero 工具: 在 LLM 客户端的对话界面中，通过 '/tools zotero <工具名称> <参数>' 的形式调用 Zotero MCP 服务器提供的工具。

常用工具示例

  • 检索文献: '/tools zotero zotero_search_items query="machine learning" limit=5' (检索关键词为 "machine learning" 的文献，最多返回 5 条结果)
  • 获取文献元数据: '/tools zotero zotero_get_item_metadata item_key="文献条目key"' (获取指定 Key 的文献的详细元数据)
  • 获取文献全文: '/tools zotero zotero_get_item_fulltext item_key="文献条目key"' (获取指定 Key 的文献的全文内容，如果可用)
  • 检索 PDF 注释: '/tools zotero zotero_get_annotations item_key="文献条目key"' (获取指定 Key 的文献 PDF 中的注释)

更多可用工具及参数请参考仓库 README 文档的 "📚 Available Tools" 章节。

信息

分类

生产力应用

访问项目