MiiKiyoshi/tex-mcp-web

Agentic-first PDF review for LaTeX papers: live web viewer + comment queue + MCP server for Claude Code

About tex-mcp-web

Review a LaTeX paper from its rendered PDF while Claude Code or Codex edits the source.

You read the PDF in a browser and leave comments on selected text, sections, or the whole paper. The coding agent reads those comments through MCP and edits the LaTeX source. The running web server detects the edit, rebuilds the PDF, and displays it in the same browser.

tex-mcp-web requires Python 3.10 or newer and a supported document compiler on PATH. LaTeX projects use latexmk by default; pdflatex, xelatex, lualatex, and pandoc are also supported.

Register tex-mcp-web once for the agent you use.

tex-mcp is the process that the agent starts for the MCP connection. You do not run it separately after registration.

Each paper needs a .tex-mcp-web.yaml in its project root. This file identifies the paper, tells the web server what to compile and watch, and lets the MCP process find the same project when the agent is working in a subdirectory.

Without this file, tex-web falls back to main.tex on port 8765 in the current directory. That fallback does not mark the project root or assign a per-paper port, so the normal MCP workflow uses .tex-mcp-web.yaml.

Enter the paper directory and create the file if it does not already exist:

--main is the path to the top-level source file, relative to the project root. init refuses to overwrite an existing .tex-mcp-web.yaml.

Field Effect ------ main Top-level source file compiled into the PDF. watch File patterns that trigger recompilation after a change. Patterns are matched against filenames and project-relative paths. ignore Paths checked befor

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/MiiKiyoshi--tex-mcp-web.html)

Related MCP servers