dsh-overleaf
DSH bundle that exposes multiple Overleaf projects through OverleafMCP
安装
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:fly233338/dsh-overleaf说明文档
阅读完整 README ↗dsh-overleaf
通过 OverleafMCP 将多个 Overleaf 项目连接到 DeepSeek Harness(DSH)。
dsh-overleaf 将 OverleafMCP 作为 npm 依赖安装,通过 MCP stdio 启动它,并将其工具暴露给 DSH。本项目不复制 OverleafMCP 的源代码。
功能
支持浏览和读取多个 Overleaf 项目中的文件、检查文档章节和章节内容、通过 Git 将文件或章节写回 Overleaf,并使用 DSH 宿主提供的 MCP Client。根据我的体验,尤其适用于以下场景:理解整个 LaTeX 项目、自动修复 LaTeX 编译错误、全文统一术语/符号。
要求
- DSH
0.1.0-rc.5或兼容版本。 - Node.js
22.19.0或更高版本。 - 一个 Overleaf Git 集成 token。
安装
从 DSH 源码目录安装:
cd /path/to/deepseek-harness
pnpm install
pnpm run build
pnpm dsh plugin --profile web add /path/to/dsh-overleaf
如果 DSH CLI 已安装并且可以从 PATH 使用:
dsh plugin --profile web add dsh-overleaf
dsh web
本项目发布后即可使用 npm 安装命令。
配置
插件使用其 index.js 所在目录中的 dsh-overleaf.config.json。如果文件不存在,插件会在启动时创建它。每行填写一个项目 ID,并使用同一个 token:
{
"gitToken": "your-overleaf-git-token",
"projectIds": [
"project-id-a",
"project-id-b"
]
}
项目 ID 可以从 Overleaf 项目 URL 中的 `` 获取。请在 Overleaf Account Settings → Git Integration 中创建 Git token。
编辑配置文件后重启 DSH。插件只在启动时读取配置,并生成 OverleafMCP 的内部项目配置。不要编辑生成的 .dsh-overleaf.projects.json 文件。
插件不读取 .env,也不要求设置 Overleaf 环境变量。
与模型一起使用
告诉模型要处理哪个项目:
Please work on Overleaf project project-id-a and read its main.tex.
模型会先调用 mcp__overleaf__list_projects,然后在后续 Overleaf 工具调用中将选中的项目 ID 作为 projectName。写入操作必须提供明确的 commitMessage,并会通过 Git 向 Overleaf 提交。
请勿将 token 提交到公开源码仓库或发布到 npm 包中。
范围
当前版本通过一个 MCP 工具组支持多个 Overleaf 项目。不支持编译文档、审阅 PDF 或自动化浏览器。