MCP サーバー
fontstay パッケージには Model Context Protocol サーバーが含まれています。エディターの AI エージェントは、ローカルのフォントファイルを読み取り、対象ユーザーに合わせてフォールバックフォントを選び、このアプリと同じフォールバック CSS を書き出せます。
できること
サーバーは stdio 経由でお使いのマシン上で動作します。エージェントが指定したフォントファイルだけを読み取り、何も書き込まず、ネットワークリクエストも行いません。ステートレスで、呼び出しごとにファイルと対象ユーザーを指定するため、エージェントは別のオプションで何度でも問い合わせられます。
ツール
サーバーは、読み取り専用のツールを 4 つ公開しています。
analyze_font: フォントファイルを説明します:名前、ウェイトとスタイル、検出された種類、縦方向のメトリクス、文字体系、グリフ数、可変軸、OpenType 機能、ライセンス。suggest_fallbacks: 各オペレーティングシステムでフォールバックに選ばれたシステムフォント、システムごとの対象ユーザーのシェア、そしてそのフォールバックが、出現頻度で重み付けしたフォントのグリフをどれだけ共有しているかを一覧にします。get_css: @font-face と font-family の CSS を生成します。アプリやコマンドラインと同一の結果です。get_export: 同じ調整結果を、CSS 変数、Tailwind、Next.js、Nuxt、Astro、WordPress の theme.json、Fontaine、preload タグ、読み込みスクリプトとして出力し、推奨ファイル名を添えます。
analyze_font 以外のすべてのツールは、1 ~ 16 個のフォントファイル(WOFF2、WOFF、TTF、OTF。1 ファイルあたり最大 10 MB)と、コマンドラインと同じオプション(audience(Browserslist クエリ)、systems、locale、kind、unicode_range、scripts)を受け取ります。グリフの重なりが少ない場合や、フォールバックフォントのないシステムは、結果の後に警告として返されます。
セットアップ
サーバーを MCP クライアントに追加します。npx で起動し、Node.js 24.21 以降が必要です。
claude mcp add fontstay -- npx -y fontstay mcp設定ファイル: claude_desktop_config.json
{
"mcpServers": {
"fontstay": { "command": "npx", "args": ["-y", "fontstay", "mcp"] }
}
}設定ファイル: .cursor/mcp.json
{
"mcpServers": {
"fontstay": { "command": "npx", "args": ["-y", "fontstay", "mcp"] }
}
}設定ファイル: .vscode/mcp.json
{
"servers": {
"fontstay": { "type": "stdio", "command": "npx", "args": ["-y", "fontstay", "mcp"] }
}
}設定ファイル: ~/.codex/config.toml
[mcp_servers.fontstay]
command = "npx"
args = ["-y", "fontstay", "mcp"]パッケージがまだ npm にない場合は、チェックアウトしたリポジトリで pnpm cli:build を使ってビルドし、npx の代わりに node /path/to/packages/fontstay/dist/bin.js mcp をコマンドとして使ってください。フォントの相対パスは、エディターがサーバーを起動したディレクトリを基準に解決されます。
プロンプト例
ふだんの言葉で頼めば、エージェントがツールを選びます。
- fonts/Inter.woff2 を分析して、どの文字体系をカバーしているか教えて。
- Windows と macOS のユーザー向けに fonts/Inter.woff2 のフォールバック CSS を書いて、src/styles/fonts.css に追加して。
- Fira Sans のファイル用に Tailwind のテーマを生成して、警告を確認して。
結果のサンプル
tests/fixtures/fonts/FiraSans-Regular.ttf に対する get_css の呼び出し例です。Windows と macOS に限定し、文字体系別の追加フェイスは含めていません。
ツール呼び出し
{
"name": "get_css",
"arguments": {
"paths": ["tests/fixtures/fonts/FiraSans-Regular.ttf"],
"systems": ["windows", "macos"],
"scripts": false
}
}結果
@font-face {
font-family: "Fira Sans Fallback";
src: local("Trebuchet MS"), local("TrebuchetMS");
size-adjust: 100.3942%;
ascent-override: 93.1328%;
descent-override: 26.3959%;
line-gap-override: 0%;
}
body {
font-family: "Fira Sans", "Fira Sans Fallback", sans-serif;
/* Safari has no vertical overrides: match the x-height and fix the line box */
font-size-adjust: 0.527;
line-height: 1.4;
}
.fonts-loading {
letter-spacing: -0.0019em;
}制限
不正な入力は、エージェントが読み取って修正できるツールエラーとして返されます。
- 共有設定や統計ファイルを読み込む対象ユーザーのクエリ(extends、in package)は拒否されます。
- Windows のネットワークパス(\\host\share)は読み取りません。
- レイアウトシフトにはブラウザーが必要なため利用できません。アプリで確認してください。
- サーバーが対応する MCP プロトコルのバージョンは 2025-11-25、2025-06-18、2025-03-26、2024-11-05 で、ツールのみです。
同じエンジンは、fontstay パッケージにコマンドラインツールと Node ライブラリとしても含まれています。 CLI と Node ライブラリ