math-svg-mcp

math-svg-mcp

An MCP server that converts LaTeX math expressions to SVG.

Once configured, Claude (or your favorite AI assistant) is able to convert LaTeX math expressions to SVG. So you could, for instance, ask:

Give me the Laplace transform formula as SVG

The assistant will generate the LaTeX:

\mathcal{L}\{f(t)\} = \int_0^\infty f(t) e^{-st} \, dt = F(s)

and use the tool to render it:

Quick Install (Claude Desktop)

Download and open the .mcpb file from the latest release to automatically configure Claude Desktop.

Or use this direct link: math-svg-mcp.mcpb

Manual Configuration

Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "math-svg": {
      "command": "npx",
      "args": ["-y", "math-svg-mcp"]
    }
  }
}

Claude Code

Add to your Claude Code settings (.claude/settings.json or global settings):

{
  "mcpServers": {
    "math-svg": {
      "command": "npx",
      "args": ["-y", "math-svg-mcp"]
    }
  }
}

Or run directly:

claude mcp add math-svg -- npx -y math-svg-mcp

Other MCP Clients

Any MCP-compatible client can use this server with the same configuration pattern:

{
  "command": "npx",
  "args": ["-y", "math-svg-mcp"]
}

Global Installation (Optional)

For faster startup, install globally:

npm install -g math-svg-mcp

Then configure your client to use:

{
  "command": "math-svg-mcp"
}

Tools

latex_to_svg

Converts a LaTeX expression to SVG and returns the content directly.

Parameter	Required	Default	Description
latex	Yes	—	LaTeX math expression
unit	Yes	—	Output unit: pt, px, mm, or ex
display	No	true	Display mode (block) vs inline
fontSize	No	16	Font size in the specified unit
xHeightRatio	No	0.5	Ratio of x-height to font size
font	No	modern	Math font (see Available Fonts)

Example: E = mc^2

latex_to_svg_file

Converts a LaTeX expression to SVG and saves to a file.

Parameter	Required	Default	Description
latex	Yes	—	LaTeX math expression
outputPath	Yes	—	File path for the SVG
unit	Yes	—	Output unit: pt, px, mm, or ex
display	No	true	Display mode (block) vs inline
fontSize	No	16	Font size in the specified unit
xHeightRatio	No	0.5	Ratio of x-height to font size
font	No	modern	Math font (see Available Fonts)

Example: \int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2} → /tmp/gaussian.svg

Available Fonts

The font parameter lets you choose from 10 math fonts. The default modern font (Latin Modern) is bundled; others are automatically downloaded on first use and cached in ~/.cache/math-svg-mcp/fonts/.

Font	Description
modern	Latin Modern (default, bundled)
stix2	STIX Two Math
newcm	New Computer Modern
fira	Fira Math
bonum	TeX Gyre Bonum
pagella	TeX Gyre Pagella
schola	TeX Gyre Schola
termes	TeX Gyre Termes
dejavu	DejaVu
asana	Asana Math

Requirements

• Node.js 18 or later

Development

npm install
npm run build
npm test

License

MIT