跳到正文
fontstay.dev
GitHub 上的源代码
主题
视觉模拟

用于设计检查,不能矫正色觉。

阅读辅助

MCP 服务器

fontstay 包内含一个 Model Context Protocol 服务器。编辑器中的 AI 智能体可以读取您的本地字体文件,针对您的受众选出回退字体,并写出与本应用相同的回退 CSS。

功能说明

服务器通过 stdio 在您的机器上运行。它只读取智能体指明的字体文件,不写入任何内容,也不发出任何网络请求。它是无状态的:每次调用都会指明自己的文件,并携带自己的受众,因此智能体可以用不同的选项再次询问。

工具

服务器提供四个只读工具。

除 analyze_font 外,所有工具都接受 1 到 16 个字体文件(WOFF2、WOFF、TTF 或 OTF,每个最大 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 构建,并用 node /path/to/packages/fontstay/dist/bin.js mcp 代替 npx 作为命令。相对字体路径相对于编辑器启动服务器时所在的目录解析。

示例提示词

用日常语言提问即可;智能体会自行选择工具。

示例结果

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

限制

错误输入会以工具错误的形式返回,智能体可以读取并更正。

同一引擎也以命令行工具和 Node 库的形式提供,包含在 fontstay 包中。 CLI 与 Node 库