Zotero MCP Server

Zotero MCP Server

site icon
2025.03.18 0
Python文献管理引用生成开发效率
Zotero MCP Server 是一个与 Zotero 集成的模型上下文协议(MCP)服务器,允许 AI 应用程序访问和操作 Zotero 库。它提供了搜索、引用、添加项目等功能,支持个人和群组库。
View on GitHub

Overview

基本能力

产品定位

Zotero MCP Server 是一个与 Zotero 集成的模型上下文协议(MCP)服务器,旨在为 AI 应用程序提供访问和操作 Zotero 库的能力。

核心功能

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

适用场景

  • AI 应用程序需要访问或操作 Zotero 库的场景
  • 自动化文献管理和引用生成
  • 学术研究和写作辅助工具

工具列表

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

常见问题解答

  • 如何获取 Zotero API 密钥和用户 ID? 运行 ./find_zotero_id.py 脚本可以帮助找到 Zotero 用户 ID。
  • 如何配置群组库? 在 .env 文件中取消注释并设置 ZOTERO_GROUP_ID

使用教程

使用依赖

  1. 克隆仓库: bash git clone https://github.com/your-username/zotero-mcp-server.git cd zotero-mcp-server
  2. 创建虚拟环境: bash python -m venv venv
  3. 激活虚拟环境:
  4. Linux/macOS: bash source venv/bin/activate
  5. Windows: bash venv\Scripts\activate
  6. 安装依赖: bash pip install -r requirements.txt

安装教程

  1. 复制环境文件示例: bash cp .env.example .env
  2. 编辑 .env 文件,设置 Zotero API 密钥和用户 ID: ZOTERO_API_KEY=your_api_key_here ZOTERO_USER_ID=your_numeric_user_id_here # ZOTERO_GROUP_ID=your_group_id_here # 取消注释以使用群组库

调试方式

  1. 运行服务器: bash python src/server.py
  2. 测试服务器: bash ./simple_test.py
  3. 集成 AI 应用程序: 参考 USAGE_GUIDE.md 文件中的详细示例。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。