hedwigai

Overleaf MCP：通过 Claude Code、Codex 或 Cursor 检查并编译 Overleaf 论文

使用你已经在用的 AI Agent 处理 Overleaf 项目。通过一个托管的 MCP 服务 hedwigai，你的 Agent 可以：

• 检查 .bib 中的每条参考文献。 每个条目都会在 Crossref、doi.org 和网络上查询。结果会显示为已找到、已找到但年份或作者不同，或未找到。属于另一篇论文的 DOI 和已撤稿论文都会被标记。
• 检查每个引用参考文献的句子。 系统会阅读被引用的作品，并将句子判定为有依据、与原文矛盾或缺乏依据，同时提供能够说明结论的段落。
• 将项目编译为 PDF。 使用真实的 TeX（Tectonic），支持 BibTeX 和 IEEEtran、acmart、elsarticle 等期刊类，每次运行最长 4 分钟，无需安装任何内容。如果编译失败，会返回出错行供 Agent 修复。

Overleaf 没有自己的 MCP 服务。大多数社区服务通过 Overleaf 的 Git 集成（需要付费的 Overleaf 计划）或你的登录信息来访问项目。有些服务使用你自行安装的 TeX 进行编译，并将 \cite 键与 .bib 匹配。它们都不会检查参考文献是否真实存在。本仓库提供了执行此操作的配置，并且适用于 Overleaf 免费计划。

hedwigai 与 Overleaf 没有关联。

1. 将 Overleaf 项目下载到本地

任选以下一种方式：

Overleaf 计划	方法
免费	在编辑器中选择：菜单 → 下载 → 源文件（或 文件 → 下载为源文件（.zip））。解压文件。
付费	git clone https://git.overleaf.com/<project id>（项目的 Git 链接），然后 git push 将 Agent 的更改推送回去。
付费	GitHub 同步：拉取 Overleaf 同步到的仓库。

在 Agent 中打开该文件夹。

2. 连接 MCP 服务

服务地址为 https://mcp.hedwigai.com。你只需通过 OAuth 登录一次。新账户会获得 $1 额度，无需绑定银行卡。

Claude Code

claude mcp add --transport http --scope user hedwigai https://mcp.hedwigai.com

然后运行 /mcp，选择 hedwigai 和 Authenticate。或者将本仓库的 .mcp.json 复制到项目中，以使用项目级服务。

Codex

codex mcp add hedwigai --url https://mcp.hedwigai.com
codex mcp login hedwigai

Cursor：将以下内容添加到 ~/.cursor/mcp.json，然后点击 连接：

{ "mcpServers": { "hedwigai": { "url": "https://mcp.hedwigai.com" } } }

Claude（网页版或桌面版）：选择「设置 → 连接器 → 添加自定义连接器」，然后粘贴 https://mcp.hedwigai.com。

技能（可选）。 在 Claude Code 中运行 /plugin marketplace add un-seen/hedwigai-skills，然后运行 /plugin install hedwigai@hedwigai，即可添加 reference-checker 和 latex-papers 技能，引导 Agent 完成每个步骤。

3. 提出请求

将 AGENTS.md（Codex、Cursor）或 CLAUDE.md（Claude Code）复制到项目中，让 Agent 了解工作流。然后提出请求：

Check every reference in references.bib and tell me which ones are wrong.
Check that each sentence citing a paper says what that paper says.
Compile main.tex with render_document and fix any errors.

在示例项目上试用

example/ 是一篇短论文，其 refs.bib 中设置了两个问题：

• pijoanmas2006 引用了 Pijoan-Mas（2006）的论文，DOI 为 10.1016/j.red.2005.11.001。该 DOI 实际登记给同一期中 Domeij 和 Flodén 的论文。正确的 DOI 是 …11.002。
• wakefield1998 引用了一篇已于 2010 年撤稿的 Lancet 论文。

在 Agent 中打开 example/，连接服务并要求它检查参考文献。它会标记出这两个问题。该论文目前也可以正常编译。

没有 Agent？在浏览器中检查 .bib

以下免费工具无需账户（每天可检查 3 次，每次最多 25 个条目）：

• BibTeX 检查器：粘贴来自 Overleaf 或 Zotero 的 .bib。
• 撤稿检查器：查找参考文献列表中的撤稿论文。
• DOI 检查器：检查每个 DOI 是否存在，以及对应的是否是你所指的论文。
• 引用检查器：将每个文内引用与参考文献列表进行匹配。

费用

编译免费。检查参考文献和引用句子按条从预付余额中扣费；一篇有 80 条参考文献的论文只需几美元。请参阅定价。

限制

• 不支持实时协同编辑、修订跟踪或历史记录：这些功能仍由 Overleaf 提供。
• 已禁用 Shell escape，因此 minted 无法运行（请使用 listings）。
• 不支持 biber（请使用 BibTeX），也不支持 LuaLaTeX。
• TeX 宏包集使用 TeX Live 2022 的版本。
• “未找到”仅代表一项发现，并不能证明文献是伪造的：Crossref 经常缺少书籍、论文、报告以及非常新或非英文的作品。

更多

• 适用于 Claude Code 的 Overleaf MCP：与社区版 Overleaf MCP 服务的比较。
• 一个 LaTeX MCP 服务：使用 Claude Code 编译一篇完整的 IEEE 论文。
• hedwigai-skills：Agent 技能。

采用 MIT 许可。欢迎提交问题和拉取请求。