Zotero MCP Lite

关键词

Zotero本地数据库注释管理BibTeX 导出学术研究

使用说明（Markdown格式）

  • 项目简介

    • Zotero MCP Lite 是一个用 Python 实现的 MCP 服务器，面向学术研究场景，能够对本地 Zotero 库进行查询、获取元数据、读取附件、生成 BibTeX、创建笔记等操作，并提供若干研究性提示模板。服务器通过 MCP 协议对客户端提供统一的 JSON-RPC 风格接口，支持多种传输协议（如标准输入输出 stdio、SSE、WebSocket），以便与大语言模型等客户端无缝对接。

  • 主要功能点（简明版）

    • 9 个原子工具，用于搜索、查找最近条目、获取集合与集合内条目、读取元数据、读取全文、获取笔记与注释等，以及创建笔记。
    • 4 条研究提示模板，辅助进行文学综述、跨论文对比、知识发现和参考文献导出等工作流。
    • 本地 Zotero 数据库的直接访问与缓存，尽量减少网络依赖，提升响应速度。
    • 支持通过本地 Zotero Connector API 写入新笔记，以及通过本地 API 读取元数据与注释。
    • 提供灵活的客户端配置入口，便于在不同环境中运行与对接。

  • 安装步骤（简要操作）

    1. 确保已安装 Python 3.8 及以上版本。
    2. 克隆本仓库到本地，进入项目根目录。
    3. 安装依赖（示例，实际环境如需请按项目要求安装对应版本）：
      • fastmcp
      • pyzotero
      • httpx
      • mistune
      • python-dotenv
      • 以及运行时所需的其它库
    4. 启动服务器（两种常用方式之一）：
      • 使用可执行命令启动（推荐，若已安装包装入口）： zotero-mcp serve
      • 或直接通过 Python 模块运行（在开发环境中可用）： python -m zotero_mcp.cli serve
    5. 连接 MCP 客户端并开始请求服务器提供的工具与提示模板。

  • 服务器配置（MCP 客户端需要从配置中知道如何启动 MCP 服务器） 服务器启动配置样例（注释说明，非代码块，便于理解）：

    • server_name: Zotero MCP Lite
      • command: zotero-mcp
      • args: ["serve"] 注释：server_name 是对该 MCP 服务器的描述性名称；command 是启动服务器的命令；args 是传给启动命令的参数。实际使用时，客户端需要以此信息来启动并连接到 MCP 服务器。

  • 基本使用方法

    • 启动后，客户端可以通过 JSON-RPC 的 MCP 请求调用已注册的工具（如 zotero_search_items、zotero_get_item_metadata 等），获取格式化的文本输出、BibTeX、或笔记与注释信息。
    • 可以结合本地数据库注释能力，快速获取某篇论文的高亮注释、笔记等内容，支撑高效的学术研究工作流。

  • 额外说明

    • 客户端与服务器的通信是通过 MCP 协议实现的 JSON-RPC 风格请求/响应，服务器端实现了多种传输模式，以适配不同的部署场景（stdio、SSE、WebSocket 等）。
    • 若要在不同环境中使用，请确保 Zotero 本地应用已正确配置本地 API 与 Connector API 的访问权限，并按需设置 ZOTERO_LIBRARY_ID、ZOTERO_LIBRARY_TYPE、以及本地 API 访问设置。

服务器信息

访问项目