LaTeX를 PDF로 렌더링하는 작은 FastMCP 기반 Microservice. 서버는 MCP 도구를 노출 LaTeX 또는 템플릿을 렌더링하고 artifacts (a .tex 파일 및 .pdf)를 생성합니다. 아래 src/artifacts/.

이 저장소는 로컬 실행을 준비하고 Claude Desktop에 의해로드됩니다 (via 모형 Context 의정서). 기본 엔트리포인트는 run_server.py입니다.

데모

---

빠른 특징

• pdflatex를 사용하여 원시 LaTeX를 .tex] 및 (선택) .pdf]에 렌더링
• Jinja2 템플릿 렌더링 및 PDF로 컴파일
• Claude Desktop 및 기타 MCP-capable 클라이언트용 MCP 서버로 실행

이 MCP 서버에서 노출된 도구

• 총 도구 : 5
• render latex document - LaTeX를 작성하고 선택적으로 PDF로 컴파일
• render template document - Jinja2 템플릿을 렌더링하고 선택적으로 컴파일
• list templates - 목록 가능한 템플릿
• list artifacts - [T4]에서 생성 된 목록 파일
• get template - 템플릿 파일의 원료 내용을 반환하므로 클라이언트가 렌더링하기 전에 검사 할 수 있습니다.

---

시작하기 (현지 개발)

자주 묻는 질문

• Python 3.10+ (프로젝트는 현대pydantic/fastapi 더미를 이용합니다)

FastMCP LaTeX Server (tex-mcp)

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:

git clone https://github.com/devroopsaha744/TexMCP.git
cd TexMCP

After cloning you can follow the venv creation and install steps below.

python -m venv .venv
. .\\.venv\\Scripts\\Activate.ps1
python -m pip install --upgrade pip
pip install -r requirements.txt

2. Run the server directly (stdio mode - used by Claude Desktop)

. .\\.venv\\Scripts\\Activate.ps1
python .\\run_server.py
# or run the venv python explicitly if you don't activate
.# .venv\\Scripts\\python.exe run_server.py

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