AI导哈

Zotero MCP Lite

Zotero MCP Lite 是一个高性能的模型上下文协议（MCP）服务器，为Zotero提供可定制的研究工作流程。

  • by xmruuu
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 xmruuu/zotero-mcp-lite

使用说明

Zotero MCP Lite

Zotero的高性能模型上下文协议（MCP）服务器，具有可定制的研究工作流程。

  • 完全本地 -没有云，没有API密钥；完全通过Zotero桌面运行
  • 原子工具 -9个可组合工具；LLM根据需要进行编排
  • MCP本地 -适用于任何MCP客户端
  • 可扩展 -用户可编辑的提示，以匹配您的研究风格
  • 易于部署 -单命令安装，自动检测Zotero

建筑

flowchart LR
    subgraph MCP [Zotero MCP Lite]
        Read[Read Operations]
        Write[Write Operations]
    end
  
    subgraph Zotero [Zotero Desktop]
        LocalAPI["/api/ endpoint"]
        ConnectorAPI["/connector/ endpoint"]
        SQLite[(zotero.sqlite)]
    end
  
    Read -->|GET| LocalAPI
    Read -->|Direct SQL| SQLite
    Write -->|POST saveItems| ConnectorAPI
    LocalAPI --> SQLite
    ConnectorAPI --> SQLite

快速开始

先决条件

  1. Python 3.10+
  2. 佐特罗7+ 已安装（本地API是Zotero 7功能；不支持早期版本）

步骤0：启用Zotero本地API

本地API允许第三方应用程序与Zotero进行通信。 这是必需的。

步骤：

  1. 打开 佐特罗 → 编辑 → 设置 （或 偏好 在macOS上）
  2. 首选 高级 标签
  3. 在...之下 通用 （在Zotero 7中），检查 “允许此计算机上的其他应用程序与Zotero通信”
  4. API将于 http://localhost:23119/api/

注： 本地API需要手动启用（与浏览器连接器不同）。

步骤1：安装

推荐：

uv tool install zotero-mcp-lite

替代方案（需要Python 3.10+）：

pip install zotero-mcp-lite
Alternative: Install from GitHub or source 
# From GitHub (latest development version)
uv tool install "git+https://github.com/xmruuu/zotero-mcp-lite.git"

# From source (for development)
git clone https://github.com/xmruuu/zotero-mcp-lite.git
cd zotero-mcp-lite && uv sync
uv run zotero-mcp setup

# Direct run without install
uvx zotero-mcp-lite serve

步骤2：设置

zotero-mcp setup

这会检测您的Zotero安装并自动配置MCP客户端。

步骤3：连接到MCP客户端

克劳德代码 （一个命令）：

claude mcp add zotero -- zotero-mcp serve

其他MCP客户端 --添加到MCP配置文件中：

{
  "mcpServers": {
    "zotero": {
      "command": "zotero-mcp",
      "args": ["serve"]
    }
  }
}

配置文件位置： claude_desktop_config.json （克劳德桌面），设置→ MCP（光标）， ~/.gemini/settings.json （Gemini CLI）

就是这样！您已经准备好将Zotero与AI助手一起使用了。

远程设置（claude.ai web·Word插件·移动设备）

默认值 serve 命令使用 标准 运输，仅适用于本地安装 客户端（克劳德桌面、光标、克劳德代码）。让Zotero MCP在 claude.ai 网络，the Microsoft Word Claude加载项，或穿过您的任何其他表面 claude.ai帐户，服务器必须作为自定义连接器通过HTTPS可访问。

需要预先了解的两个架构现实：

  • Zotero必须在 同一台机器 作为MCP服务器，服务器与Zotero的 当地API 127.0.0.1:23119每个用户运行自己的服务器；没有中心托管实例 这是可能的。
  • claude.ai定制连接器 仅支持OAuth （未粘贴不记名代币）。此服务器 嵌入了一个小型OAuth 2.1授权服务器，同时支持DCR（RFC 7591）和CIMD，因此 claude.ai的连接器流是开箱即用的。

最快路径：向导

zotero-mcp setup --remote

这将：

  1. 下载 cloudflared 如果它还没有在您的系统上（缓存在您的用户数据目录下）。
  2. 生成一个随机管理员密码并将其写入 .env （或重复使用现有的）。
  3. 启动Cloudflare隧道并捕获公众 *.trycloudflare.com URL。
  4. 在启用OAuth的情况下启动MCP服务器。
  5. 打印连接器URL以粘贴到claude.ai中→ 设置→ 连接器→ 添加自定义 连接器。当登录页面出现在浏览器中时，输入步骤2中的密码。
  6. 注意OAuth握手是否完成并打印 有联系的！

让窗口保持打开状态——关闭它会停止隧道和服务器。对于长时间运行的 部署，作为系统服务运行。

手动设置

喜欢自己接线吗？在中设置两个环境变量 .env:

ZOTERO_MCP_ADMIN_PASSWORD=<a long random string>
ZOTERO_MCP_PUBLIC_URL=https://<your-tunnel-url>

开始你选择的隧道：

隧道 为什么
Cloudflare 隧道 免费、稳定的URL，无需注册 *.trycloudflare.com. cloudflared tunnel --url http://localhost:8000
吸烟 最容易快速测试。自由层每次重新启动时都会轮换URL。 ngrok http 8000
尾鳞片漏斗 免费，提供稳定 *.ts.net HTTPS URL。需要一个Tailscale帐户。

然后运行服务器：

zotero-mcp serve --transport streamable-http --port 8000

添加公共URL（带 /mcp claude.ai上的路径： 设置→ 连接器→ 添加自定义 连接器.

安全注意事项

  • 管理员密码是 仅 在公众面前保护你的Zotero图书馆 互联网。使用强随机密码。这 .env 文件很敏感--保留其文件 权限紧，不要提交。
  • --no-auth 作为本地调试的逃生口存在。永远不要暴露未经身份验证的 通过隧道连接服务器——任何拥有该URL的人都可以读取 并写 你的Zotero图书馆 （包括 zotero_create_note).
  • OAuth令牌保存在用户数据目录下的SQLite文件中。删除该文件 有效地注销claude.ai。

特性

9原子MCP工具

搜索与导航

  • zotero_search_items -带标签过滤的关键字搜索
  • zotero_get_recent -最近修改/添加的项目（默认情况下不包括注释）
  • zotero_get_collections -列出所有收藏
  • zotero_get_collection_items -集合中的项目（默认情况下不包括注释）
  • zotero_search_annotations -跨库搜索亮点（PDF、EPUB、快照）

内容读取

  • zotero_get_item_metadata -元数据、作者、摘要、标签
  • zotero_get_item_children -附件、注释和注解（PDF/EPUB/snapshot）
  • zotero_get_item_fulltext -全文提取

写作 （通过本地连接器API）

  • zotero_create_note -创建具有完整格式支持的笔记（表格、列表、换行符）

4研究技能（MCP提示）

指导人工智能完成常见学术任务的预定义工作流程：

技能 用例 它的作用
knowledge_discovery(query) 探索主题 搜索标题和注释
literature_review(item_key) 深入一篇论文 从注释或全文进行结构化分析
comparative_review(item_keys) 比较论文 表格丰富的综合与见解
bibliography_export(item_keys) 准备引用 APA、IEEE和BibTeX格式

使用或不使用注释。完全可定制。看 自定义技能.

调试

调试MCP服务器可能具有挑战性。使用MCP检查器：

npx @modelcontextprotocol/inspector zotero-mcp serve

这将打开一个web UI，以交互方式测试工具和提示。

技术说明

  • 注释：直接SQLite查询（比Web API快，离线工作）
  • 跨平台：在Windows、macOS、Linux上自动检测Zotero
  • 架构：通过阅读 /api/，通过写 /connector/，通过SQLite进行注释

自定义技能

提示完全可定制。从包默认值复制并编辑：

~/.zotero-mcp/prompts/
├── literature_review.md      # Single paper analysis skill
├── comparative_review.md     # Multi-paper comparison skill
├── knowledge_discovery.md    # Topic exploration skill
└── bibliography_export.md    # Citation export skill

加载顺序： 用户文件(~/.zotero-mcp/prompts/)优先于包默认值。

编辑 .md 用于自定义分析部分、添加新部分或完全更改输出格式的文件。

学分

多亏了 @ 54YYY 对于原件 佐特罗mcp 项目。

许可证

MIT许可证-请参阅 许可证 文件。

相关 MCP