MCP 服务器
fontstay 包内含一个 Model Context Protocol 服务器。编辑器中的 AI 智能体可以读取您的本地字体文件,针对您的受众选出回退字体,并写出与本应用相同的回退 CSS。
功能说明
服务器通过 stdio 在您的机器上运行。它只读取智能体指明的字体文件,不写入任何内容,也不发出任何网络请求。它是无状态的:每次调用都会指明自己的文件,并携带自己的受众,因此智能体可以用不同的选项再次询问。
工具
服务器提供四个只读工具。
analyze_font: 描述一个字体文件:名称、字重和样式、检测到的类型、纵向度量、文字、字形数量、可变轴、OpenType 特性和许可证。suggest_fallbacks: 列出每个操作系统上选作回退字体的系统字体、各系统的受众占比,以及这些回退字体与该字体共有的字形占比(按使用频率加权)。get_css: 生成 @font-face 和 font-family CSS,与应用和命令行的结果完全相同。get_export: 同一匹配结果,输出为 CSS 变量、Tailwind、Next.js、Nuxt、Astro、WordPress theme.json、Fontaine、预加载标签或加载脚本,并附带建议的文件名。
除 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配置文件: 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 构建,并用 node /path/to/packages/fontstay/dist/bin.js mcp 代替 npx 作为命令。相对字体路径相对于编辑器启动服务器时所在的目录解析。
示例提示词
用日常语言提问即可;智能体会自行选择工具。
- 分析 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,仅支持工具。
同一引擎也以命令行工具和 Node 库的形式提供,包含在 fontstay 包中。 CLI 与 Node 库