Перейти к содержимому
fontstay.dev
Исходный код на GitHub
Тема
Симуляция зрения

Для проверки дизайна; не корректирует цветовое зрение.

Помощь при чтении

MCP-сервер

В пакет fontstay входит сервер Model Context Protocol. ИИ-агент в вашем редакторе читает локальные файлы шрифтов, подбирает резервные шрифты под вашу аудиторию и пишет тот же CSS, что и это приложение.

Что он делает

Сервер работает на вашем компьютере через stdio. Он читает только файлы шрифтов, которые назвал агент, ничего не записывает и не обращается к сети. Состояния нет: каждый вызов называет свои файлы и несёт свою аудиторию, так что агент может повторить запрос с другими параметрами.

Инструменты

Сервер предоставляет четыре инструмента, которые только читают данные.

Все инструменты, кроме 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

Если пакета ещё нет в npm, соберите его в клонированном репозитории командой pnpm cli:build и используйте node /path/to/packages/fontstay/dist/bin.js mcp вместо npx. Относительные пути к шрифтам отсчитываются от каталога, в котором редактор запускает сервер.

Примеры запросов

Пишите обычными словами; инструменты агент выберет сам.

Пример результата

Вызов 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;
}

Ограничения

Неверный ввод возвращается ошибкой инструмента, которую агент может прочитать и исправить.

Тот же движок доступен как инструмент командной строки и библиотека Node в пакете fontstay. CLI и библиотека для Node