Allows compiling TikZ code into high-resolution PNG images with transparent background, using LaTeX and TikZ libraries.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@tikz-mcp draw a sine wave from 0 to 2π"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A lightweight MCP (Model Context Protocol) server that compiles TikZ code into high-resolution PNG images. Lets AI assistants render and preview LaTeX/TikZ diagrams during conversations.
Single tool: compile_tikz -- pass TikZ code, get a PNG image
Auto-wrapping: Raw TikZ commands are automatically wrapped in a standalone document
Custom preamble: Pass your own \usepackage / \usetikzlibrary commands
High resolution: Output at 1000 DPI by default, with transparent background
Graceful errors: LaTeX compilation errors are captured and returned as readable messages
Style guide: Built-in aesthetic rules injected into AI instructions for consistent, publication-quality output
Self-verification: AI is instructed to inspect its own output and fix issues before presenting to the user
Zero idle cost: Uses stdio transport -- no background process when not in use
Related MCP server: LaTeX PDF MCP Server
Python >= 3.10
LaTeX: pdflatex in PATH (e.g. via MacTeX or TeX Live)
Poppler: pdftoppm in PATH (install via brew install poppler), OR Ghostscript gs in PATH (ships with MacTeX)
pip install tikz-mcpOr install from source:
git clone https://github.com/FlorianHuo/tikz-mcp.git
cd tikz-mcp
pip install .Add to your MCP client config (e.g. Antigravity settings.json, Claude Desktop claude_desktop_config.json):
{
"mcpServers": {
"tikz-mcp": {
"command": "tikz-mcp",
"args": []
}
}
}Or run with python:
{
"mcpServers": {
"tikz-mcp": {
"command": "python3",
"args": ["-m", "tikz_mcp.server"]
}
}
}compile_tikzParameter | Type | Required | Description |
| string | Yes | TikZ code (raw commands or full document) |
| string | No | Custom LaTeX preamble (replaces default) |
Example -- raw TikZ code:
\begin{tikzpicture}
\draw[thick, ->] (0,0) -- (3,0) node[right] {$x$};
\draw[thick, ->] (0,0) -- (0,3) node[above] {$y$};
\draw[blue, thick] (0,0) circle (2);
\end{tikzpicture}The server auto-wraps this in a standalone document with common TikZ libraries loaded.
Example -- full document:
\documentclass[border=5pt]{standalone}
\usepackage{tikz}
\begin{document}
\begin{tikzpicture}
\fill[red] (0,0) rectangle (2,2);
\end{tikzpicture}
\end{document}Rendered PNGs are saved to $HOME/.tikz-mcp/output/ and the full path is returned.
When raw TikZ code is provided (without \documentclass), the following preamble is used:
\usepackage{tikz}
\usepackage{amsmath,amssymb}
\usetikzlibrary{
arrows.meta, calc, decorations.pathmorphing,
decorations.markings, patterns, positioning,
shapes.geometric, shapes.misc, fit, backgrounds,
intersections, through, matrix, trees,
}Override by passing a custom preamble parameter.
MIT
Embedded STYLE_GUIDE.md into server instructions with inline code patterns and anti-patterns
Added physical/mathematical accuracy rules (real hyperbolas, correct slopes)
Added TikZ pitfalls section (dimension overflow, hatched fill workarounds)
Added self-verification workflow: AI must inspect output and fix issues before presenting
Default standalone border changed from 5pt to 8pt
Initial release
compile_tikz tool with auto-wrapping, custom preamble, 1000 DPI output
stdio transport for zero idle resource usage
This server cannot be deployed
Generate dynamic Mermaid diagrams and charts with AI assistance. Customize styles and export diagr…
Persistent AI LaTeX workspace: edit and compile multi-file projects, export publication-ready PDFs.
Create workflow, sequence, architecture, and mind map diagrams via AI assistants.
Create and edit architecture diagrams from your AI agent; get an SVG and a live editable canvas.