Zotero MCP Connector 使用说明

项目简介

Zotero MCP Connector 是一个基于 Model Context Protocol (MCP) 的服务器实现，它将您的本地 Zotero 知识库连接到��持 MCP 协议的客户端，如 Claude Desktop。通过此 Connector，您可以使用 Claude 等工具直接访问和操作您的 Zotero 文献库，实现文献检索、信息提取和 PDF 文件获取等功能，提升科研和信息处理效率。

主要功能点

浏览 Zotero 馆藏: 列出您 Zotero 库中的所有 Collections (文集)。
文集内容获取: 获取指定 Collection 中的所有条目 (文献)。
文献详情查询: 获取特定文献的详细信息，包括标题、作者、摘要等。
全文检索: 在整个 Zotero 库中执行关键词搜索。
最近添加文献: 获取最近添加到 Zotero 库中的文献列表。
PDF 文件获取: 检索并获取 Zotero 文献条目关联的 PDF 文件。

安装步骤

安装 uv: 按照 uv 官方文档安装 uv 包管理器。

克隆仓库: 在本地克隆 Zotero MCP Connector 仓库：

git clone https://github.com/gyger/mcp-pyzotero.git
cd mcp-pyzotero

安装依赖: 使用 uv 创建虚拟环境并安装项目依赖：
```
uv sync
```
启用 Zotero Local API: 在 Zotero 7 中启用本地 API。操作步骤：'Edit' -> 'Preferences' -> 'Advanced' -> 'Local API' -> 勾选 'Enable Zotero API for other applications' (具体参考 'README.md' 中的图片)。
安装 MCP 服务器: 使用 uv 运行 'mcp install' 命令安装 Zotero Connector 到 MCP 客户端（如 Claude Desktop）：
```
uv run mcp install zotero.py
```

服务器配置

MCP 客户端（如 Claude Desktop）需要配置 MCP 服务器的启动命令和参数才能连接 Zotero MCP Connector。以下是配置信息示例 (JSON 格式)：

{
  "serverName": "Zotero Connector",  // 自定义服务器名称，方便在客户端识别
  "command": "uv",                // 启动命令，这里使用 uv 包管理器
  "args": [                       // 命令参数
    "run",                       // uv 的 run 子命令，用于运行脚本
    "mcp",                       // 运行 mcp 命令，由 mcp 包提供
    "run",                       // mcp 的 run 子命令，用于启动服务器
    "zotero.py"                  // 指定服务器主程序文件为 zotero.py
  ]
}

参数说明:

'serverName': MCP 服务器的名称，在客户端中显示，可以自定义。
'command': 启动服务器的命令，这里使用 'uv'，确保您的环境中已安装 uv。
'args': 传递给 'command' 的参数列表，按照顺序依次为 'run', 'mcp', 'run', 'zotero.py'。

可选配置 - Zotero 用户 ID: 如果您的 Zotero 用户 ID 不是默认的 '0'，可以通过环境变量 'ZOTERO_USER_ID' 进行配置。例如，将 Zotero 用户 ID 设置为 '12345' 的配置如下：

{
  "serverName": "Zotero Connector",
  "command": "uv",
  "args": [
    "run",
    "mcp",
    "run",
    "zotero.py",
    "-v",                       // 传递环境变量的参数
    "ZOTERO_USER_ID=12345"      // 设置环境变量 ZOTERO_USER_ID 的值为 12345
  ]
}

基本使用方法

在 MCP 客户端中添加服务器: 根据 MCP 客户端（如 Claude Desktop）的指引，添加新的 MCP 服务器，并将上述 JSON 配置信息填入。
使用工具: 成功连接后，您可以在 MCP 客户端中使用 Zotero Connector 提供的工具。工具名称和描述对应 'zotero.py' 文件中 '@mcp.tool' 装饰器定义的函数，例如：
- 'get_collections()': "List all collections in the local Zotero library."
- 'get_collection_items(collection_key)': "Gets all items in a specific Zotero collection."
- 'search_library(query)': "Search the local Zotero library of the user." 等等。
查阅客户端文档: 具体工具的使用方法和参数，请参考您的 MCP 客户端的文档。

注意: 使用此 Connector 前，请确保您的本地 Zotero 7 已经成功安装并启用了 Local API 功能。

关键词