Zotero MCP 服务器

一个与 Zotero 集成的模型上下文协议 (MCP) 服务器，允许 AI 应用程序访问和操作 Zotero 文献库。

功能

• 在 Zotero 文献库中搜索条目
• 获取引用和参考文献
• 向 Zotero 文献库添加新条目
• 访问合集和条目
• 支持个人和群组文献库

安装

1. 克隆仓库：

   git clone https://github.com/your-username/zotero-mcp-server.git
   cd zotero-mcp-server
   

2. 创建一个虚拟环境：

   python -m venv venv
   

3. 激活虚拟环境：

   • 在 Linux/macOS 上：

     source venv/bin/activate
     

   • 在 Windows 上：

     venv\Scripts\activate
     

4. 安装依赖：

   pip install -r requirements.txt
   

配置

1. 复制示例环境文件：

   cp .env.example .env
   

2. 使用您的 Zotero API 凭据编辑 .env 文件：

   ZOTERO_API_KEY=your_api_key_here
   ZOTERO_USER_ID=your_numeric_user_id_here
   # ZOTERO_GROUP_ID=your_group_id_here  # 取消注释以使用群组文献库
   

   您需要设置 ZOTERO_USER_ID（用于个人文献库）或 ZOTERO_GROUP_ID（用于群组文献库）。

3. 如果您不确定如何找到您的 Zotero 用户 ID，请运行：

   ./find_zotero_id.py
   

用法

运行服务器

python src/server.py

服务器将启动并监听标准输入/输出上的 JSON-RPC 请求。

测试服务器

./simple_test.py

这将运行一系列测试以验证服务器是否正常工作。

与 AI 应用程序集成

Zotero MCP 服务器可以与支持模型上下文协议的 AI 应用程序集成。 有关详细示例，请参见 USAGE_GUIDE.md 文件。

可用资源

• zotero://collections: Zotero 文献库中的合集列表
• zotero://items/top: Zotero 文献库中的顶级条目
• zotero://items/recent: Zotero 文献库中最近添加或修改的条目
• zotero://collections/{collection_key}/items: 特定 Zotero 合集中的条目
• zotero://items/{item_key}: 特定 Zotero 条目的详细信息
• zotero://items/{item_key}/citation/{style}: 特定 Zotero 条目在特定样式中的引用

可用工具

• search_items: 在 Zotero 文献库中搜索条目
• get_citation: 获取特定条目的引用
• add_item: 向 Zotero 文献库添加新条目
• get_bibliography: 获取多个条目的参考文献

文档

有关更多详细信息，请参见：

• USAGE_GUIDE.md: 综合使用指南
• test_client.py: 交互式测试客户端
• simple_test.py: 简单测试脚本
• find_zotero_id.py: 帮助查找您的 Zotero ID 的脚本

许可证

MIT

贡献

欢迎贡献！ 请随时提交 Pull Request。