fly233338/dsh-overleaf
Connect Overleaf projects to DeepSeek Harness (DSH) through OverleafMCP and MCP tools.
dsh-overleaf connects multiple Overleaf projects to DeepSeek Harness through @fly233338/overleaf-mcp: it installs the MCP server as an npm dependency, starts it through MCP stdio, and exposes its tools to DSH so the model can browse and read files from multiple Overleaf projects, inspect document sections and section content, and write files or sections back to Overleaf through Git (write operations require an explicit commitMessage and push a Git commit). Per the author, it is especially useful for understanding an entire LaTeX project, automatically fixing LaTeX compilation errors, and unifying terminology and symbols throughout a document. Configuration is a single JSON file (gitToken + projectIds) under $DSH_HOME/dsh-overleaf/; the plugin generates the internal OverleafMCP project configuration at startup and does not read .env or require Overleaf environment variables.
Install
dsh plugin --profile web add dsh-overleafnpm package dsh-overleaf 0.1.3 (registry-verified 2026-08-24; the README notes the npm install command becomes available after publication — it is published). Install with the dsh CLI on PATH: dsh plugin --profile web add dsh-overleaf, then dsh web. From a DSH source checkout: pnpm install && pnpm run build, then pnpm dsh plugin --profile web add /path/to/dsh-overleaf and pnpm dsh web. Requires DSH 0.1.0-rc.5 or compatible, Node.js 22.19.0+, and an Overleaf Git integration token. Configuration: dsh-overleaf.config.json under $DSH_HOME/dsh-overleaf/ (default ~/.dsh/dsh-overleaf/) with one shared gitToken and one project ID per line; restart DSH after editing. The plugin installs @fly233338/overleaf-mcp as an npm dependency, starts it through MCP stdio, and exposes its tools to DSH.
Compatibility
DeepSeek Harness 0.1.0-rc.5 or a compatible release. Node.js 22.19.0 or newer. Requires an Overleaf Git integration token (Overleaf Account Settings → Git Integration). Wraps @fly233338/overleaf-mcp (started via MCP stdio) and exposes its tools through the DSH MCP Client provided by the host. Current scope: browse/read multiple Overleaf projects, inspect document sections, write files or sections back via Git (write operations require an explicit commitMessage). Does not compile documents, review PDFs, or automate a browser.
Details
- Repo: fly233338/dsh-overleaf
- Category: Infrastructure & Deployment
- Stars: 7
- Version: npm package dsh-overleaf 0.1.3 (registry-verified 2026-08-24)
- Last push: 2026-08-22
- First seen: 2026-08-14
Recent updates
The current bilingual README (primary English) documents: features (browse/read multiple projects, section inspection, Git write-back), requirements (DSH 0.1.0-rc.5+, Node.js 22.19+, Overleaf Git token), install (dsh CLI and source-checkout paths), configuration file format, usage pattern (tell the model which project ID to handle; write ops need an explicit commitMessage), scope boundaries, and links to @fly233338/overleaf-mcp and the DSH plugin guide.
FAQ
- How do I find my Overleaf project ID?
- Take the <id> from the Overleaf project URL. Add one project ID per line in the projectIds array of dsh-overleaf.config.json, plus one shared gitToken created under Overleaf Account Settings → Git Integration.
- Does the plugin compile documents or review PDFs?
- No — the current version supports multiple Overleaf projects through one MCP tool group (browse, read, inspect sections, write back via Git). It does not compile documents, review PDFs, or automate a browser.
- How do writes to Overleaf work?
- Write operations require an explicit commitMessage and push a Git commit to Overleaf through the Git integration token. Keep the token out of public repositories and published package contents.
Alternatives
joejojoking-cloud/dsh-file-explorer · omdsh-dev/dsh-annotation · shuguang1994/project-blueprint