Zotero MCP 服务器

一个 Model Context Protocol (MCP) 服务器，集成到 Zotero 中，允许 AI 应用程序访问和操作 Zotero 图书馆。

功能

• 搜索 Zotero 图书馆中的项目
• 获取引文和 bibliography
• 添加新项目到 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 服务器可以与支持 Model Context Protocol 的 AI 应用程序集成。请参阅 USAGE_GUIDE.md 文件获取详细示例。

可用资源

• zotero://collections: Zotero 图书馆中的集合列表
• zotero://items/top: 图书馆中的顶级项目
• zotero://items/recent: 最近添加或修改的项目
• zotero://collections/{collection_key}/items: 特定集合中的项目
• zotero://items/{item_key}: 特定 Zotero 项目的详细信息
• zotero://items/{item_key}/citation/{style}: 特定项目的特定格式的引文

可用工具

• search_items: 在 Zotero 图书馆中搜索项目
• get_citation: 获取特定项目的引文
• add_item: 添加新项目到 Zotero 图书馆
• get_bibliography: 多个项目获取 bibliography

文档

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

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

许可证

MIT

贡献

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