MCP-сервер
В пакет fontstay входит сервер Model Context Protocol. ИИ-агент в вашем редакторе читает локальные файлы шрифтов, подбирает резервные шрифты под вашу аудиторию и пишет тот же CSS, что и это приложение.
Что он делает
Сервер работает на вашем компьютере через stdio. Он читает только файлы шрифтов, которые назвал агент, ничего не записывает и не обращается к сети. Состояния нет: каждый вызов называет свои файлы и несёт свою аудиторию, так что агент может повторить запрос с другими параметрами.
Инструменты
Сервер предоставляет четыре инструмента, которые только читают данные.
analyze_font: Описывает файл шрифта: названия, насыщенность и начертание, определённый тип, вертикальные метрики, письменности, число глифов, оси вариативного шрифта, возможности OpenType и лицензию.suggest_fallbacks: Перечисляет системный шрифт, выбранный резервным в каждой операционной системе, долю каждой системы в аудитории и то, какую часть веса глифов шрифта разделяют с ним резервные.get_css: Генерирует CSS @font-face и font-family, идентичный CSS приложения и командной строки.get_export: Та же подгонка в виде CSS-переменных, Tailwind, Next.js, Nuxt, Astro, WordPress theme.json, Fontaine, тегов preload или загрузочного скрипта с предлагаемым именем файла.
Все инструменты, кроме analyze_font, принимают от одного до 16 файлов шрифтов (WOFF2, WOFF, TTF или OTF, до 10 МБ каждый) и те же параметры, что и командная строка: 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 и скажи, какие письменности он покрывает.
- Напиши CSS резервных шрифтов для fonts/Inter.woff2 для пользователей Windows и macOS и добавь его в src/styles/fonts.css.
- Сгенерируй тему Tailwind для моих файлов Fira Sans и проверь предупреждения.
Пример результата
Вызов get_css для tests/fixtures/fonts/FiraSans-Regular.ttf, только для 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