math-svg-mcp

math-svg-mcp

一个可将 LaTeX 数学表达式转换为 SVG 的 MCP 服务。

完成配置后，Claude（或你喜欢的 AI 助手）即可将 LaTeX 数学表达式转换为 SVG。例如，你可以这样提问：

给我拉普拉斯变换公式的 SVG

助手会生成 LaTeX：

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

并使用工具进行渲染：

快速安装（Claude Desktop）

下载并打开 .mcpb 文件，即可自动配置 Claude Desktop：最新版本。

或者使用此直接链接：math-svg-mcp.mcpb

手动配置

Claude Desktop

将以下内容添加到 Claude Desktop 配置文件中：

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

将以下内容添加到 Claude Code 设置（.claude/settings.json 或全局设置）中：

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

或直接运行：

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

其他 MCP 客户端

任何兼容 MCP 的客户端都可以使用相同的配置方式来使用此服务：

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

全局安装（可选）

如需更快启动，可进行全局安装：

npm install -g math-svg-mcp

然后将客户端配置为使用：

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

工具

latex_to_svg

将 LaTeX 表达式转换为 SVG，并直接返回内容。

参数	必填	默认值	说明
latex	是	—	LaTeX 数学表达式
unit	是	—	输出单位：pt、px、mm 或 ex
display	否	true	显示模式（块级）或行内模式
fontSize	否	16	指定单位下的字号
xHeightRatio	否	0.5	x 高度与字号的比值
font	否	modern	数学字体（参见可用字体）

示例： E = mc^2

latex_to_svg_file

将 LaTeX 表达式转换为 SVG 并保存到文件。

参数	必填	默认值	说明
latex	是	—	LaTeX 数学表达式
outputPath	是	—	SVG 文件路径
unit	是	—	输出单位：pt、px、mm 或 ex
display	否	true	显示模式（块级）或行内模式
fontSize	否	16	指定单位下的字号
xHeightRatio	否	0.5	x 高度与字号的比值
font	否	modern	数学字体（参见可用字体）

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

可用字体

font 参数允许你从 10 种数学字体中进行选择。默认的 modern 字体（Latin Modern）已随包提供；其他字体会在首次使用时自动下载，并缓存到 ~/.cache/math-svg-mcp/fonts/。

字体	说明
modern	Latin Modern（默认，随包提供）
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

要求

• Node.js 18 或更高版本

开发

npm install
npm run build
npm test

许可证

MIT