devroopsaha744/TexMCP

A small FastMCP-based Microservice that renders LaTeX to PDF. The server exposes MCP tools
to render raw LaTeX or templates and produces artifacts (a .tex file and .pdf)
under src/artifacts/.
This repository is prepared to run locally and to be loaded by Claude Desktop (via the
Model Context Protocol). The default entrypoint is run_server.py.
Demo
---
Quick features
- Render raw LaTeX to .tex and (optionally) .pdf using pdflatex
- Render Jinja2 templates and compile to PDF
- Designed to run as an MCP server for Claude Desktop and other MCP-capable clients
Tools exposed by this MCP server
- Total tools: 5
- render_latex_document — write LaTeX and optionally compile to PDF
- render_template_document — render a Jinja2 template and optionally compile
- list_templates — list available templates
- list_artifacts — list files produced in src/artifacts/
- get_template — return the raw contents of a template file so clients can inspect it before rendering
---
Getting started (local development)
Prerequisites
- Python 3.10+ (the project uses modern pydantic/fastapi stack)
- LaTeX toolchain (pdflatex) for PDF compilation (optional; if missing, server returns .tex only)
1) Create a project virtualenv and install deps
Clone from GitHub
If you want to work from the canonical repository on GitHub, clone it first:
After cloning you can follow the venv creation and install steps below.
2) Run the server directly (stdio mode - used by Claude Desktop)
If run in stdio mode the server will speak MCP over stdin/stdout (this is what Claude Desktop
expects when it spawns the process). If you prefer HTTP, edit run_server.py and switch the
transport to http (see commented code) and run via uv run or uvicorn.
3) Artifacts
Rendered outputs are placed in src/artifacts/. For each job you should see a .tex file and
— if pdflatex is available — a matching .pdf.
Templates
- Several example templates live in src/mcp_server/templates/. There are 15 templates included (for example sample_invoice.tex.j2, sample_letter.tex.j2, sample_resume.tex.j2). Use list_templates to get the full list programmatically. The templates are deliberately simple and ready to customize — add your own .tex.j2 files to that folder to expand the catalog.
Included templates (in src/mcp_server/templates/)
- default.tex.j2 (base example template)
- sample_invoice.tex.j2
- sample_invoice2.tex.j2
- sample_letter.tex.j2
- sample_report.tex.j2
- sample_resume.tex.j2
- sample_presentation.tex.j2
- sample_certificate.tex.j2
- sample_coverletter.tex.j2
- sample_poster.tex.j2
- sample_thesis.tex.j2
- sample_receipt.tex.j2
- sample_recipe.tex.j2
- sample_poem.tex.j2
- sample_cv.tex.j2
---
Integration with Claude Desktop (quick)
Recommended: use the fastmcp CLI installer which will set things up to run from the project directory and use the project venv.
From your project root (with the venv already created and deps installed):
This ensures uv runs inside the project directory and uses the project's environment. After the installer runs, fully quit and restart Claude Desktop.