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