llm-for-zotero MCP工具
经 AI Skill Hub 精选评估，llm-for-zotero MCP工具 获评「强烈推荐」。已获得 1.4k 颗 GitHub Star，这款MCP工具在功能完整性、社区活跃度和易用性方面表现出色，AI 评分 8.2 分，适合有一定技术背景的用户使用。
📚 深度解析
通过安装 llm-for-zotero MCP工具，你的 AI 助手将获得额外的工具调用能力，可以用自然语言直接操控该工具的功能，无需学习复杂的命令行语法。MCP 工具的核心价值在于"一次配置，永久增强"——配置完成后，每次与 AI 对话时都可以无缝调用这些工具。
在技术实现上，MCP 工具通过标准的 JSON-RPC 协议与 AI 客户端通信，工具的功能以"工具列表"的形式暴露给 AI 模型，AI 可以按需调用。llm-for-zotero MCP工具 提供了结构化的工具调用接口，使 AI 模型能够精确地理解和使用每个功能点，显著降低 AI 在工具使用上的错误率。
与传统的 API 集成相比，MCP 工具的优势在于无需编写代码——用户只需在配置文件中添加几行 JSON，即可让 AI 获得全新能力。AI Skill Hub 将 llm-for-zotero MCP工具 评为 AI 评分 8.2 分，属于同类工具中的优质选择。
📋 工具概览
基于MCP协议的开源研究代理系统，深度集成Zotero文献库，支持学术论文分析、文献管理和智能查询。适合学术研究者、论文写手和知识工作者快速检索、组织和分析研究资料。
llm-for-zotero MCP工具 是一款遵循 MCP（Model Context Protocol）标准协议的 AI 工具扩展。通过 MCP 协议，它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务，实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用，都可以通过自然语言在 AI 对话中直接触发，极大提升生产效率。
📖 中文文档
基于MCP协议的开源研究代理系统，深度集成Zotero文献库，支持学术论文分析、文献管理和智能查询。适合学术研究者、论文写手和知识工作者快速检索、组织和分析研究资料。
llm-for-zotero MCP工具 是一款遵循 MCP（Model Context Protocol）标准协议的 AI 工具扩展。通过 MCP 协议，它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务，实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用，都可以通过自然语言在 AI 对话中直接触发，极大提升生产效率。
- 通过标准 MCP 协议与 Claude、Cursor 等主流 AI 客户端深度集成
- 提供结构化工具调用接口，显著降低 AI 集成复杂度
- 支持 Claude Desktop 和 Claude Code 无缝接入，开箱即用
- 可与其他 MCP 工具组合叠加，构建完整 AI 工作站
- 轻量无侵入设计，不影响现有系统架构
- 在 Claude Desktop 对话中直接调用本地工具，实现 AI 与系统的深度联动
- 通过自然语言驱动复杂的多步骤自动化任务，代替繁琐手动操作
- 将多个 MCP 工具组合使用，构建个人专属 AI 工作站
# 方式一：通过 Claude Code CLI 一键安装
claude skill install https://github.com/yilewang/llm-for-zotero
# 方式二：手动配置 claude_desktop_config.json
{
"mcpServers": {
"llm-for-zotero-mcp--": {
"command": "npx",
"args": ["-y", "llm-for-zotero"]
}
}
}
# 配置文件位置
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%/Claude/claude_desktop_config.json
- 确认已安装 Node.js（v18 或以上版本）
- 打开 Claude Desktop 或 Claude Code 的 MCP 配置文件
- 按「交给 Agent 安装 → Claude Desktop」标签中的 JSON 配置填入 mcpServers 字段
- 保存配置文件并重启 Claude 客户端
- 重启后，在对话中即可使用本工具
# 安装后在 Claude 对话中直接使用 # 示例： 用户: 请帮我用 llm-for-zotero MCP工具 执行以下任务... Claude: [自动调用 llm-for-zotero MCP工具 MCP 工具处理请求] # 查看可用工具列表 # 在 Claude 中输入："列出所有可用的 MCP 工具"
// claude_desktop_config.json 配置示例
{
"mcpServers": {
"llm-for-zotero_mcp__": {
"command": "npx",
"args": ["-y", "llm-for-zotero"],
"env": {
// "API_KEY": "your-api-key-here"
}
}
}
}
// 保存后重启 Claude Desktop 生效
llm-for-zotero: A Research Agent System for your Zotero Library
<p align="center"> <img src="./assets/label.png" alt="LLM for Zotero logo: a brain icon merged with the Zotero shield" width="512" /> </p>
llm-for-zotero brings Large Language Models into the Zotero reader, so you can ask questions, summarize papers, inspect figures, compare sources, and save notes without leaving your library. It works with standard API providers, local OpenAI-compatible models, WebChat, Codex App-Server, and Claude Code.
Documentation:
<p align="center"> <img src="./assets/demo.png" alt="Screenshot of the llm-for-zotero sidebar inside the Zotero PDF reader" width="1024" /> </p>
<p align="center"> <img src="./assets/demo2.png" alt="Screenshot of the llm-for-zotero sidebar inside the Zotero PDF reader" width="1024" /> </p>
What's New
- Codex App Server is the recommended Codex path for ChatGPT Plus users. It runs through the local codex app-server runtime and is configured from the Agent tab. - Claude Code Mode runs Claude Code as a separate conversation system inside Zotero through a companion local bridge. It is experimental and does not yet support native Zotero API operations. - Skills let you customize how Agent Mode handles research workflows. The plugin ships with 8 built-in skills and a portal for creating your own. - Standalone Window Mode opens the assistant in a dedicated window with paper chat, library chat, and conversation history. - File-Based Notes save Markdown notes to local folders, including Obsidian, Logseq, or any plain Markdown directory. - Cache-aware Agent Mode preserves stable paper context, prior read evidence, and coverage state across longer research turns, then compacts old transcript history automatically when the context window gets crowded. - Citation navigation now keeps citation labels conservative until page locations are verified, while quote-based citations can jump back to the matching Zotero passage. - MinerU PDF parsing provides higher-fidelity extraction for tables, equations, figures, and local mineru-api servers, with a richer file manager for bulk parsing, cache repair, sync packages, tags, and parsing filters.
Thanks to @jianghao-zhang and @boltma for major contributions to the Codex App Server, Claude Code, and file upload workflows.
Codex Setup (ChatGPT Plus Subscribers)
If you have a ChatGPT Plus subscription, you can use Codex models in the plugin without a separate API key by signing in through the Codex CLI.
New users should choose Codex App Server from the Agent tab. The older Codex Auth (Legacy) path remains available for existing users, but is planned for future deprecation after app-server validation.
<details> <summary>Codex App Server setup and legacy Codex Auth</summary>
<p align="center"> <img src="./assets/codex_claude.png" alt="Screenshot showing recommended Codex App Server configuration in plugin settings" width="512" /> </p>
Codex App Server setup
- Install the Codex CLI:
npm install -g @openai/codex
On macOS, you can also use brew install --cask codex. On Windows, install Codex from PowerShell or Command Prompt rather than WSL, so Zotero MCP can use the Windows-local loopback connection.
- Log in:
codex login
Credentials are saved to ~/.codex/auth.json.
3. In Zotero, open Preferences -> llm-for-zotero -> Agent tab. 4. Turn on Enable Codex App Server integration. 5. Choose the default model and reasoning level. 6. Click Test connection. 7. In the chat header, click Codex to switch into the Codex conversation system.
Codex App Server and Claude Code are mutually exclusive runtime modes in the Agent tab. Disable one before enabling the other.
Claude Code Setup (Experimental)
Claude Code mode runs Claude Code as a separate conversation system inside Zotero. It reuses the sidebar and standalone-window UI, but has separate conversation history, scope state, model settings, permission semantics, slash commands, and project skills.
Claude Code mode currently does not support native Zotero API operations. Use built-in Agent Mode for native library tools such as reading item state, editing notes, tagging papers, updating metadata, or importing items.
<details> <summary>Claude Code prerequisites, bridge setup, and project assets</summary>
Prerequisites:
- A working Claude Code CLI installation. Follow Anthropic's official Claude Code installation, quickstart, and authentication docs. - The claude command must be on PATH and authenticated. - Node.js and npm for the companion bridge adapter.
1. Install and verify Claude Code
Run:
claudeComplete any login or authentication prompts before continuing.
WebChat Setup (ChatGPT & Deepseek Web Sync)
WebChat mode sends questions to chatgpt.com and deepseek.com through a browser extension, then streams responses back into Zotero. It is useful when you want ChatGPT/deepseek web access without a provider API key.
<p align="center"> <img src="./assets/webchat.gif" alt="Screenshot of WebChat mode connected to chatgpt.com" width="1024" /> </p>
Prerequisites:
- A ChatGPT account for
chatgpt.comWebChat or a Deepseek account fordeepseek.comWebChat. - A Chromium-based browser such as Chrome.
Setup:
1. Download the latest extension.zip from sync-for-zotero releases. 2. Unzip it. 3. Open chrome://extensions, enable Developer Mode, choose Load unpacked, and select the unzipped extension folder. 4. In Zotero, open Preferences -> llm-for-zotero and set Auth Mode -> WebChat. 5. ⚠️: Keep a ChatGPT tab open in your browser. A green dot in Zotero means the extension and ChatGPT tab are connected. Make sure the tab and Zotero stay in the same monitor. No minimization or backgrounding, or the connection may drop.
Quick Start
1. Download the latest .xpi file from the Releases page. 2. In Zotero, open Tools -> Add-ons -> gear icon -> Install Add-on From File, then select the .xpi. 3. Restart Zotero. 4. Open Preferences -> llm-for-zotero, choose a provider, enter the base URL, key, and model, then click Test Connection. 5. Open a PDF in Zotero and click the LLM Assistant icon in the right-hand toolbar.
If you do not want to use a provider API key, start with WebChat or Codex App Server.
Demos
Agent Mode Demos
Multi-step workflow
<p align="center"> <img src="./assets/agent/multi_steps.gif" alt="Animation showing multi-step agent workflow" width="512" /> </p>
Find related papers
<p align="center"> <img src="./assets/agent/related_papers.gif" alt="Animation showing agent finding related papers in the library" width="1024" /> </p>
Apply tags
<p align="center"> <img src="./assets/agent/apply_tags.gif" alt="Animation showing agent applying tags to a paper" width="1024" /> </p>
Write a note
<p align="center"> <img src="./assets/agent/write_note.png" alt="Screenshot showing agent writing a note for a paper" width="1024" /> </p>
Configuration
Open Preferences -> llm-for-zotero.
- Select your Provider.
- Paste your API Base URL, secret key, and model name.
- Click Test Connection.
<p align="center"> <img src="./assets/model_setting.gif" alt="Animation showing provider and model configuration" width="1024" /> </p>
The plugin supports multiple provider protocols, including responses_api, openai_chat_compat, anthropic_messages, and gemini_native.
You can configure multiple providers and models for different tasks, such as a multimodal model for figures and a text model for summaries. The conversation panel also supports model-specific reasoning levels and hyperparameters such as temperature and max_tokens_output.
<a id="features"></a>
Multi-Paper Comparison
Open multiple papers in Zotero tabs and type / to cite another paper as additional context.
<p align="center"> <img src="./assets/multi.gif" alt="Animation showing cross-paper comparison using the slash command" width="1024" /> </p>
Zotero Notes vs. File-Based Notes (both generated by the plugin)
<p align="center"> <img src="./assets/note2.jpeg" alt="Zotero internal note" width="512" /> </p>
<p align="center"> <img src="./assets/obsidian_example.png" alt="Example of a paper note rendered in Obsidian" width="512" /> </p>
Notes use Pandoc citation syntax such as [@citekey], which works with Obsidian Zotero Integration, Pandoc plugins, and many Markdown readers.
Note templates and figure-embedding rules live in the write-note skill. Open the Standalone Window -> Skills portal to edit them.
FAQ
Q: Does it require an API key to use this plugin? A: It depends on the backend you choose. The plugin supports multiple backends with different requirements:
| Goal | Recommended path | API key required? |
|---|---|---|
| Use OpenAI, Gemini, DeepSeek, Moonshot, or another provider | Configure an API provider in Zotero preferences | Yes |
| Use a local model | Connect any OpenAI-compatible local HTTP API | Usually no |
| Use ChatGPT in the browser | [WebChat](#webchat-setup-chatgpt-web-sync) with the Sync for Zotero extension | No |
| Use Codex models with ChatGPT Plus | [Codex App Server](#codex-setup-chatgpt-plus-subscribers) | No separate API key |
| Use Claude Code inside Zotero | [Claude Code bridge](#claude-code-setup-experimental) | Claude Code auth |
| Improve PDF extraction for tables, equations, and figures | [MinerU PDF parsing](#mineru-pdf-parsing) | Personal MinerU key recommended |
Q: Is it free to use? Yes, the plugin is free. You only pay for API calls if you choose a paid provider. With Codex App Server, ChatGPT Plus subscribers can use Codex models without a separate API key. If you find this helpful, consider leaving a star on GitHub or buying me a coffee.
<p align="center"> <img src="https://github.com/user-attachments/assets/1e945e57-4b99-4d25-b8d5-fb120e100b62" width="200" alt="Alipay donation QR code"> </p>
Q: Is my data used to train models? The plugin does not train models. Data handling depends on the backend you choose: your configured API provider, local model, WebChat, Codex, Claude Code, or MinerU.
Q: How do I report a bug or ask a question? Please open an issue on GitHub.
llm-for-zotero 是一个为 Zotero Library 研究助手系统的项目，旨在为 Zotero 用户提供高级研究辅助功能。
该项目提供了多种功能，包括 Codex App Server、Claude Code Mode 和 Skills 等，用户可以根据自己的需求选择使用。
该项目不需要任何环境依赖或系统要求。
如果您是 ChatGPT Plus 订阅者，可以使用 Codex App Server 方式无需额外 API 密钥即可使用 Codex 模型。具体安装步骤请参见 Codex App Server setup 部分。
使用该项目的步骤包括下载最新的 .xpi 文件、安装到 Zotero 中、配置提供者和 API 基础 URL 等。具体使用步骤请参见 Quick Start 部分。
配置说明包括选择提供者、填写 API 基础 URL、秘钥和模型名称等。具体配置步骤请参见 Configuration 部分。
FAQ 部分回答了用户常见的问题，包括是否需要 API 密钥等。具体问题答案请参见 FAQ 部分。
创新性强的学术工具，MCP架构规范，活跃维护。将LLM与文献管理深度融合，解决研究者的实际痛点。代码质量高，生态潜力大。
- 需要让 Claude / Cursor 操作本地工具的 AI 工程师
- 构建多智能体协作系统的 Agent 开发者
- 构建企业知识库 / RAG 检索应用的团队
- 跨境业务、多语言内容运营团队
- 配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效
- CLI：直接 npm install -g / pip install，命令行调用
- 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
⚡ 核心功能
- 通过标准 MCP 协议与 Claude、Cursor 等主流 AI 客户端深度集成
- 提供结构化工具调用接口，显著降低 AI 集成复杂度
- 支持 Claude Desktop 和 Claude Code 无缝接入，开箱即用
- 可与其他 MCP 工具组合叠加，构建完整 AI 工作站
- 轻量无侵入设计，不影响现有系统架构
- 需要让 Claude / Cursor 操作本地工具的 AI 工程师
- 构建多智能体协作系统的 Agent 开发者
- 构建企业知识库 / RAG 检索应用的团队
- 跨境业务、多语言内容运营团队
- 配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效
👥 适合人群
🎯 使用场景
- 在 Claude Desktop 对话中直接调用本地工具，实现 AI 与系统的深度联动
- 通过自然语言驱动复杂的多步骤自动化任务，代替繁琐手动操作
- 将多个 MCP 工具组合使用，构建个人专属 AI 工作站
⚖️ 优点与不足
- +标准化 MCP 协议，生态互联性强
- +与 Claude 官方生态无缝对接
- +即插即用，配置简单快捷
- −依赖 Claude 客户端，非 Claude 用户无法使用
- −MCP 协议仍在持续演进，接口可能变更
- −需要一定的配置步骤
该工具使用 AGPL-3.0 协议，商用场景请仔细阅读协议条款，必要时咨询法律意见。
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
⚠️ AGPL 3.0 — 最严格的 Copyleft，网络服务端使用也需开源，SaaS 使用受限。
🔗 相关工具推荐
❓ 常见问题 FAQ
AI Skill Hub 点评：llm-for-zotero MCP工具 的核心功能完整，质量优秀。对于Claude Desktop / Claude Code 用户来说，这是一个值得纳入个人工具库的选择。建议先在非生产环境试用，再逐步推广。
| 原始名称 | llm-for-zotero |
| 原始描述 | 开源MCP工具：A research agent system deeply rooted in your own Zotero library.。⭐1.4k · TypeScript |
| Topics | 学术论文文献管理LLM代理MCP工具知识管理 |
| GitHub | https://github.com/yilewang/llm-for-zotero |
| License | AGPL-3.0 |
| 语言 | TypeScript |
收录时间：2026-05-17 · 更新时间：2026-05-19 · License：AGPL-3.0 · AI Skill Hub 不对第三方内容的准确性作法律背书。