AI导哈

Zotero集成服务器

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

  • by cr625
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 cr625/zotero-mcp-server

使用说明

Zotero MCP服务器

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

与官方合作建造 MCP Python SDK 遵循最新的MCP范式和最佳实践。

特性

  • 在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. 编辑 .env 使用您的Zotero API证书提交文件：

    ZOTERO_API_KEY=your_api_key_here
ZOTERO_USER_ID=your_numeric_user_id_here
# ZOTERO_GROUP_ID=your_group_id_here  # Uncomment to use a group library

    您需要设置 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：获取多个项目的参考书目
  • create_collection：在Zotero库中创建新收藏
  • update_item：更新Zotero库中的现有项目
  • delete_item：从Zotero库中删除项目
  • get_item_types：获取所有可用Zotero物品类型的列表
  • get_item_fields：获取特定项目类型的可用字段

文档

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

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

许可证

麻省理工学院

贡献

欢迎投稿！请随时提交拉取请求。

相关 MCP