使用说明

项目简介

Zotero MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在将您的 Zotero 文献库连接到支持 MCP 协议的 AI 助手。通过该服务器，您可以利用 AI 助手便捷地搜索 Zotero 文献、获取文献元数据以及访问全文内容，从而提升科研和信息管理效率。

主要功能点

文献检索: 通过关键词在您的 Zotero 文献库中快速搜索相关条目。
元数据获取: 获取指定 Zotero 条目的详细元数据信息，如标题、作者、摘要、标签等。
全文访问: 获取 Zotero 条目关联的PDF全文内容，方便AI助手进行内容分析和利用。

安装步骤

克隆仓库

git clone https://github.com/kujenga/zotero-mcp.git
cd zotero-mcp

安装依赖 确保您已安装 uv。然后运行：
```
uv sync
```

配置环境变量 在项目根目录下创建 '.env' 文件，并根据您的 Zotero 配置填写以下环境变量：

使用本地 Zotero API (推荐，需Zotero 7或更新版本)
```
ZOTERO_LOCAL=true
```
注意: 使用本地 API 需要 Zotero 7 或更新版本正在您的电脑上运行。如果您需要访问全文API，可能需要安装 Zotero Beta Build。

使用 Zotero Web API 如果您不使用本地 API 或需要远程访问，请配置 Web API 密钥和 Library ID：

ZOTERO_API_KEY=YOUR_API_KEY  # 您的 Zotero API 密钥
ZOTERO_LIBRARY_ID=YOUR_LIBRARY_ID # 您的 Zotero Library ID (通常是 User ID)
ZOTERO_LIBRARY_TYPE=user # 文献库类型，默认为 user，也可以是 group

您可以在 Zotero 设置中创建 API 密钥并找到 Library ID。

服务器配置

要将 Zotero MCP Server 添加到 MCP 客户端（例如 Claude Desktop），您需要在客户端的 MCP 服务器配置中添加以下 JSON 配置。请根据您的实际情况进行调整。

{
  "serverName": "zotero",  // MCP 服务器名称，可以自定义
  "command": "uvx",       // 启动命令，这里使用 uvx 运行 Python 脚本
  "args": ["zotero-mcp"], // 启动命令的参数，zotero-mcp 是项目入口脚本
  "env": {
    "ZOTERO_LOCAL": "true" // (可选) 环境变量，这里设置为 true 表示使用本地 Zotero API，根据您的 .env 文件配置调整
  }
}

配置参数说明:

'serverName': 为您的 Zotero MCP 服务器指定一个名称，在 MCP 客户端中用于标识和选择该服务器。
'command': 指定启动服务器的命令。'uvx' 是一个快速的 Python 虚拟环境和包管理器，常用于运行 Python 脚本。确保您的环境中已安装 'uv'。
'args': 启动命令的参数，'["zotero-mcp"]' 表示执行项目中的 'zotero_mcp' 脚本 (在 'src/zotero_mcp/cli.py' 中定义)。
'env': (可选) 环境变量配置。'ZOTERO_LOCAL: "true"' 表示传递 'ZOTERO_LOCAL=true' 环境变量给服务器进程，告知服务器使用本地 Zotero API。您可以根据您的 '.env' 文件配置调整此项或添加其他环境变量。

基本使用方法

确保 Zotero MCP Server 已成功配置到您的 MCP 客户端中。
在 MCP 客户端中选择已配置的 "zotero" 服务器。
使用客户端提供的界面或指令，调用以下工具 (Tools) 来操作您的 Zotero 文献库：
- 'zotero_search_items': 用于搜索文献，需要提供 'query' (搜索关键词) 等参数。
- 'zotero_item_metadata': 用于获取文献元数据，需要提供 'item_key' (Zotero 条目 Key)。
- 'zotero_item_fulltext': 用于获取文献全文，需要提供 'item_key' (Zotero 条目 Key)。
AI 助手将根据您的指令调用相应的工具，并返回 Zotero 中的信息。

例如，在 Claude 中，您可以指示 Claude 使用 'zotero_search_items' 工具搜索关于 "climate change" 的文献，然后使用 'zotero_item_metadata' 或 'zotero_item_fulltext' 获取更详细的信息。

关键词