本文へスキップ
fontstay.dev
GitHub のソースコード
テーマ
色覚シミュレーション

デザイン確認用です。色覚を補正するものではありません。

読みやすさの補助

MCP サーバー

fontstay パッケージには Model Context Protocol サーバーが含まれています。エディターの AI エージェントは、ローカルのフォントファイルを読み取り、対象ユーザーに合わせてフォールバックフォントを選び、このアプリと同じフォールバック CSS を書き出せます。

できること

サーバーは stdio 経由でお使いのマシン上で動作します。エージェントが指定したフォントファイルだけを読み取り、何も書き込まず、ネットワークリクエストも行いません。ステートレスで、呼び出しごとにファイルと対象ユーザーを指定するため、エージェントは別のオプションで何度でも問い合わせられます。

ツール

サーバーは、読み取り専用のツールを 4 つ公開しています。

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

パッケージがまだ npm にない場合は、チェックアウトしたリポジトリで pnpm cli:build を使ってビルドし、npx の代わりに node /path/to/packages/fontstay/dist/bin.js mcp をコマンドとして使ってください。フォントの相対パスは、エディターがサーバーを起動したディレクトリを基準に解決されます。

プロンプト例

ふだんの言葉で頼めば、エージェントがツールを選びます。

結果のサンプル

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;
}

制限

不正な入力は、エージェントが読み取って修正できるツールエラーとして返されます。

同じエンジンは、fontstay パッケージにコマンドラインツールと Node ライブラリとしても含まれています。 CLI と Node ライブラリ