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.
analyze_font: Descreve um arquivo de fonte: nomes, peso e estilo, tipo detectado, métricas verticais, escritas, número de glifos, eixos variáveis, recursos OpenType e licença.suggest_fallbacks: Lista a fonte do sistema escolhida como alternativa em cada sistema operacional, a fatia de público de cada sistema e quanto do peso de glifos da fonte as alternativas compartilham com ela.get_css: Gera o CSS de @font-face e font-family, idêntico ao do aplicativo e da linha de comando.get_export: O mesmo ajuste como variáveis CSS, Tailwind, Next.js, Nuxt, Astro, theme.json do WordPress, Fontaine, tags preload ou um script de carregamento, com um nome de arquivo sugerido.
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 mcpArquivo de configuração: claude_desktop_config.json
{
"mcpServers": {
"fontstay": { "command": "npx", "args": ["-y", "fontstay", "mcp"] }
}
}Arquivo de configuração: .cursor/mcp.json
{
"mcpServers": {
"fontstay": { "command": "npx", "args": ["-y", "fontstay", "mcp"] }
}
}Arquivo de configuração: .vscode/mcp.json
{
"servers": {
"fontstay": { "type": "stdio", "command": "npx", "args": ["-y", "fontstay", "mcp"] }
}
}Arquivo de configuração: ~/.codex/config.toml
[mcp_servers.fontstay]
command = "npx"
args = ["-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.
- Analise fonts/Inter.woff2 e diga quais escritas ele cobre.
- Escreva o CSS de fontes alternativas de fonts/Inter.woff2 para usuários de Windows e macOS e adicione em src/styles/fonts.css.
- Gere o tema do Tailwind para meus arquivos Fira Sans e verifique os avisos.
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.
- Consultas de público que carregam uma configuração compartilhada ou arquivo de estatísticas (extends, in package) são rejeitadas.
- Caminhos de rede do Windows (\\host\share) não são lidos.
- O deslocamento de layout precisa de um navegador e não está disponível; use o aplicativo.
- O servidor fala as versões 2025-11-25, 2025-06-18, 2025-03-26 e 2024-11-05 do protocolo MCP, somente ferramentas.
O mesmo motor está disponível como ferramenta de linha de comando e biblioteca Node no pacote fontstay. CLI e biblioteca para Node