Overleaf Web MCP

Overleaf Web MCP

让 Claude、Codex、Cursor 或任何 MCP 客户端以你的身份登录，读取、编辑、编译和审阅
你的 Overleaf 项目。

文档  ·  开始使用  ·  工具  ·  安全性  ·  对比  ·  更新日志

Overleaf Web MCP 是一个 Model Context Protocol 服务。它会通过你控制的浏览器窗口登录 Overleaf 一次，然后让 AI 助手像你在 Web 编辑器中操作一样处理项目：浏览文件、进行带修订检查的编辑（也可选择以跟踪更改的方式编辑）、编译并处理审阅评论。它使用 Overleaf 编辑器所用的浏览器端点，因此核心工作流无需 Git 集成或高级套餐。

你可以这样说

连接后，只需用自然语言与助手交流。助手会选择相应的工具。

• “从我压缩的文件夹创建一个名为 Grant renewal 的新项目，并将 proposal.tex 设为根文件。”
• “列出我的 Overleaf 项目，并打开名为 Thesis 的项目。”
• “将 main.tex 的引言改写得更适合普通读者，并作为跟踪更改提交。”
• “编译论文，告诉我编译是否成功，以及错误出现在哪里。”
• “./figures 中哪些图片与项目中的不同？只上传那些不同的图片。”
• “让项目与 ~/papers/thesis 保持一致，并先告诉我哪些文件会被删除。”
• “总结尚未处理的审阅评论，并回复关于表 2 的评论。”

开始使用

你需要 Node.js 20 或更高版本、基于 Chrome 的浏览器（Chrome、Chromium、Brave 或 Edge），以及 Overleaf 账号。

说明

此服务使用 Overleaf 的私有 Web API，这些 API 可能会在不另行通知的情况下发生变化；自动化操作 www.overleaf.com 也可能涉及服务条款和账号风险。请先在一次性项目中试用，并尽量减少请求量。

1. 登录一次。 系统会打开一个专用浏览器窗口。按正常流程登录 Overleaf，包括 SSO 或双重验证。仅保存 Overleaf 来源的 Cookie，且保存到只有你本人可读取的文件中。会话有效期为最后一次使用后的五天，因此闲置五天后需要重新登录，或者安排每天运行 npx overleaf-web-mcp keepalive 以保持会话有效（参见配置）。

npx overleaf-web-mcp login

2. 连接 MCP 客户端。 对于 Claude Code：

claude mcp add overleaf --scope user -- npx -y overleaf-web-mcp serve

对于 Codex：

codex mcp add overleaf -- npx -y overleaf-web-mcp serve

{
  "mcpServers": {
    "overleaf": {
      "command": "npx",
      "args": ["-y", "overleaf-web-mcp", "serve"]
    }
  }
}

3. 重启客户端，并让它检查与 Overleaf 的连接。

各客户端的操作步骤、可自托管的 Overleaf，以及故障排查（包括 node 版本低于 20 时出现的“failed to connect”问题），请参阅安装指南。

功能

• 创建和管理项目。 创建空白项目或示例项目、克隆项目，或导入 zip 文件；先确认项目名称，再重命名、移至回收站、恢复或归档项目；设置根文档、TeX 引擎和 TeX Live 镜像，以便 Web 编辑器的 Recompile 按照这些设置运行。
• 浏览和整理。 列出和搜索项目，读取文件树及配置的根文档和编译器；创建文件夹和文件，重命名、移动、上传单个文件或文件列表，下载单个文件或整个项目的 zip 文件，并在确认后删除内容。
• 同步文件夹。 比较本地文件夹与项目而不做任何更改，然后只上传有变动的内容；还可以选择在一次经确认的调用中删除你在本地移除的内容。修改过的文本文件会像单次写入一样经过修订版本检查，因此不会覆盖协作者同时进行的编辑。
• 安全写入。 替换整个文档或单个章节。每次编辑都会与最初读取的修订版本进行核对，因此会报告协作者同时进行的更改，而不是将其覆盖。编辑可以记录为 Overleaf 修订记录。
• 按章节操作。 解析文件中的 \section 标题，读取单个章节并替换单个章节。
• 编译。 编译项目配置的根文档或指定的任意文档，并从日志中获取按文件和行号整理的错误与警告，同时明确说明编译是否成功。读取完整日志，在本地保存 PDF 或其他输出文件，或停止正在运行的编译。
• 审阅。 列出带有位置的评论串，回复评论，针对确切文本添加评论，并解决或重新打开评论串。
• 跟踪历史记录。 使用版本游标轮询项目近期历史记录，查看谁更改了什么。

工具

共 31 个工具，分为八组：账号、项目生命周期、文件、文件夹同步、章节、编译、审阅和历史记录。只读工具不会更改 Overleaf 上的内容，也不会在你的电脑上写入任何内容。破坏性工具可能会替换或移除现有内容；除 stop_compile 外，使用这些工具前都需要先复述一个值：要删除内容的路径、名称或数量，要替换文档的修订版本，文件夹同步的 planToken，或者适用于已存在文件的 overwrite。

• 文本编辑需要提供先前读取时的修订版本；如果文档在此期间发生更改，编辑会因冲突而失败。
• 跟踪更改需主动启用，绝不会在不告知的情况下退化为普通编辑。
• 删除文件需要确认其路径；删除多个文件需要确认数量；将项目移入废纸篓或删除项目需要确认项目名称。项目会先移入废纸篓；只有从废纸篓中才能永久删除。下载内容（包括整个项目的 zip 文件）绝不会覆盖本地文件，除非你明确要求；也绝不会覆盖已保存的会话。
• 写入超时后会进行观察，不会重新提交，因此不会重复应用任何更改。批量上传中的每个文件也同样如此。
• 文件夹同步需要提供 plan_sync 返回的 planToken；如果项目或文件夹自计划生成后发生了更改，同步会在修改任何内容前停止。只有镜像模式才会删除文件，而且需要确认删除数量；上传失败后绝不会进行删除。
• 上传绝不会替换文件，除非你明确要求：二进制文件需要提供 overwrite；文本文档上传时会在不检查修订版本的情况下替换，因此需要提供 uncheckedDocumentReplace。
• 你可以选择限制服务可操作的项目、电脑上的文件夹以及更改类型（访问策略）。这能确保助手只在你授权的范围内操作，但它不是沙箱。
• 你的会话 Cookie 会保存在只有你能读取的本地文件中，任何工具都不会返回它。
• 项目处于打开状态时，在最后一次调用后的最多 90 秒内，协作者可能会看到你在线。

对比

截至 2026-09-22，根据各自的源代码检查了获得星标最多的三个 Overleaf MCP 服务，以及在设计上与本项目最接近的两个。它们经常变化，请通过链接查看最新情况。✅ 支持，🟡 部分支持（见编号注释），❌ 不支持。

面向 AI Agent

服务会在 MCP 客户端连接时发送使用说明，且每个工具的说明都自成一体，因此助手无需参考此 README 也能正确使用。为项目仓库贡献代码的编码 Agent 应阅读 AGENTS.md。

许可证

MIT。这是一个独立项目，与 Overleaf 无关联，也未获其认可。