Ir para o conteúdo
fontstay.dev
Código-fonte no GitHub
Tema
Simulação de visão

Para verificar o design; não corrige a visão das cores.

Auxílios de leitura

Servidor MCP

O pacote fontstay inclui um servidor Model Context Protocol. Um agente de IA no seu editor pode ler seus arquivos de fontes locais, escolher as fontes alternativas para o seu público e escrever o mesmo CSS deste aplicativo.

O que ele faz

O servidor roda na sua máquina por stdio. Ele lê apenas os arquivos de fontes que o agente nomeia, não grava nada e não faz requisições de rede. Não guarda estado: cada chamada nomeia seus arquivos e leva seu próprio público, então o agente pode perguntar de novo com outras opções.

Ferramentas

O servidor expõe quatro ferramentas somente de leitura.

Todas as ferramentas, exceto analyze_font, aceitam de um a 16 arquivos de fontes (WOFF2, WOFF, TTF ou OTF, até 10 MB cada) e as mesmas opções da linha de comando: audience (uma consulta Browserslist), systems, locale, kind, unicode_range e scripts. Pouca sobreposição de glifos e sistemas sem fontes alternativas voltam como avisos após o resultado.

Configuração

Adicione o servidor ao seu cliente MCP. Ele inicia com npx e exige Node.js 24.21 ou mais recente.

claude mcp add fontstay -- npx -y fontstay mcp

Se o pacote ainda não está no npm, compile-o em um clone do repositório com pnpm cli:build e use node /path/to/packages/fontstay/dist/bin.js mcp como comando no lugar de npx. Caminhos relativos de fontes são resolvidos a partir do diretório em que o editor inicia o servidor.

Exemplos de pedidos

Peça em linguagem natural; o agente escolhe as ferramentas.

Resultado de amostra

Uma chamada get_css para tests/fixtures/fonts/FiraSans-Regular.ttf, limitada a Windows e macOS, sem faces extras para outras escritas.

Chamada da ferramenta

{
  "name": "get_css",
  "arguments": {
    "paths": ["tests/fixtures/fonts/FiraSans-Regular.ttf"],
    "systems": ["windows", "macos"],
    "scripts": false
  }
}

Resultado

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

Limites

Entrada inválida volta como erro da ferramenta que o agente pode ler e corrigir.

O mesmo motor está disponível como ferramenta de linha de comando e biblioteca Node no pacote fontstay. CLI e biblioteca para Node