Zotero MCP Server 使用说明

项目简介

Zotero MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在让支持 MCP 协议的客户端（如 Anthropic Claude 应用）能够访问和操作您的本地 Zotero 知识库。通过此服务器，您可以利用 LLM 的能力来搜索、分析和总结您的学术论文和笔记。

主要功能点

论文搜索：根据标签或关键词搜索 Zotero 中的论文。
获取论文笔记：获取指定论文关联的所有笔记内容。
添加论文笔记：为指定论文添加新的笔记，并可添加标签。
获取论文详情：获取指定论文的详细信息，包括标题、作者、摘要等。
请求论文总结：为指定论文添加 "待总结" 标签，触发论文总结流程（服务器端可能需要额外的后台任务或工具来实现真正的总结功能，仓库本身不包含总结功能实现，仅标记待总结）。
获取PDF内容：获取指定论文附件PDF文件的内容。

安装步骤

安装依赖：在仓库根目录下运行以下命令安装项目依赖：
```
pip install -e .
```
配置 Zotero API 密钥：
- 在仓库根目录下创建 '.env' 文件。
- 在 '.env' 文件中填入您的 Zotero API 密钥和用户 ID，例如：
```
ZOTERO_API_KEY=your_api_key_here
ZOTERO_USER_ID=your_user_id_here
```
  您可以在 Zotero 设置页面获取 API 密钥和用户 ID。

服务器配置

要将 Zotero MCP Server 集成到 MCP 客户端（例如 Anthropic Desktop App），您需要配置客户端以连接到此服务器。以下是 Anthropic Desktop App 的配置示例，您需要将配置添加到 '~/Library/Application Support/Claude/claude_desktop_config.json' 文件中（请根据您的实际路径进行调整）：

{
  "mcpServers": {
    "zotero-mcp-server": {
      "command": "bash",
      "args": [
        "-c",
        "cd /path/to/zotero-mcp-server && source .venv/bin/activate && python -m zotero_mcp.server"
      ]
    }
  }
}

配置参数说明:

'"zotero-mcp-server"': 服务器名称，在客户端中用于标识此服务器。
'"command"': 启动服务器的命令，这里使用 'bash' 来执行一系列命令。
'"args"': 启动命令的参数列表，包括：
- '"-c"': 告诉 bash 执行后面的字符串命令。
- '"cd /path/to/zotero-mcp-server && source .venv/bin/activate && python -m zotero_mcp.server"': 实际的服务器启动命令，需要替换 '/path/to/zotero-mcp-server' 为您仓库的实际路径。
  - 'cd /path/to/zotero-mcp-server': 切换到服务器仓库目录。
  - 'source .venv/bin/activate': 激活项目虚拟环境（如果使用虚拟环境）。
  - 'python -m zotero_mcp.server': 运行 Zotero MCP Server 的主程序。

注意:

确保您已在服务器仓库目录下创建并激活了 Python 虚拟环境，并安装了项目依赖。
根据您的操作系统和 Python 环境，可能需要调整 'command' 和 'args' 中的路径和命令。

基本使用方法

启动服务器：在配置好客户端后，首先需要启动 Zotero MCP Server。在服务器仓库目录下，激活虚拟环境（如果使用），然后运行以下命令：
```
python -m zotero_mcp.server
```
服务器成功启动后，会监听 MCP 客户端的请求。
在 MCP 客户端中使用：在支持 MCP 协议的客户端（如 Anthropic Claude 应用）中，配置并启用 "zotero-mcp-server" 后，客户端就可以通过 MCP 协议与服务器通信，并调用服务器提供的工具，例如：
- 在客户端中，您可以使用自然语言指令，例如 "搜索关于机器学习的论文"，客户端会将请求转换为 MCP 消息发送给 Zotero MCP Server。
- 服务器接收到请求后，会调用 'search_papers' 工具搜索 Zotero 库，并将结果返回给客户端。
- 您可以使用类似的方式调用其他工具，例如获取论文笔记、添加笔记等，具体取决于客户端的功能和界面。

请参考您的 MCP 客户端的文档，了解如何配置和使用 MCP 服务器。

关键词