项目简介
该项目是一个 MCP (Model Context Protocol) 服务器,用于将 Zotero 文献管理工具与大型语言模型 (LLM) 应用连接起来。通过该服务器,LLM 可以访问和操作用户的 Zotero 文献库,实现文献检索、信息获取等功能。
主要功能点
- 检索 Zotero 文献库: 允许 LLM 搜索用户的 Zotero 文献库,查找相关文献。
- 获取文献信息: 提供工具获取 Zotero 文献库中 Collection 列表、Collection 中的条目、以及特定条目的详细信息。
- 获取最近添加的文献: 可以获取用户最近添加到 Zotero 文献库的文献列表。
- 作为 MCP 服务器运行: 遵循 Model Context Protocol 协议,可以与任何兼容 MCP 协议的客户端(如 Claude Desktop)进行通信。
安装步骤
- 获取 Zotero API 密钥和用户 ID:
- 访问 Zotero 设置 创建一个新的 API 密钥。
- 使用 'curl' 命令和 API 密钥获取用户 ID,按照 README.md 中的步骤操作。
- 设置环境变量:
- 设置 'ZOTERO_API_KEY' 和 'ZOTERO_USER_ID' 环境变量,分别设置为你的 API 密钥和用户 ID。
- 安装 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。
基本使用方法
- 启动 MCP Zotero 服务器:在终端中运行 'mcp-zotero' 命令。
- 配置 MCP 客户端(如 Claude Desktop)连接到 'zotero' 服务器。
- 在 MCP 客户端中,可以使用预定义的工具(例如 'get_collections', 'search_library' 等)与 Zotero 文献库进行交互。具体的工具列表和使用方法请参考仓库的 README.md 文件或服务器返回的工具列表。
信息
分类
生产力应用