Servidor MCP
El paquete fontstay incluye un servidor Model Context Protocol. Un agente de IA en tu editor puede leer tus archivos de fuentes locales, elegir las fuentes alternativas para tu audiencia y escribir el mismo CSS que esta aplicación.
Qué hace
El servidor se ejecuta en tu equipo por stdio. Solo lee los archivos de fuentes que nombra el agente, no escribe nada y no hace peticiones de red. No guarda estado: cada llamada nombra sus archivos y lleva su propia audiencia, así que el agente puede preguntar de nuevo con otras opciones.
Herramientas
El servidor ofrece cuatro herramientas de solo lectura.
analyze_font: Describe un archivo de fuente: nombres, peso y estilo, tipo detectado, métricas verticales, escrituras, número de glifos, ejes variables, funciones OpenType y licencia.suggest_fallbacks: Enumera la fuente del sistema elegida como alternativa en cada sistema operativo, la cuota de audiencia de cada sistema y cuánto del peso de glifos de la fuente comparten con ella las alternativas.get_css: Genera el CSS de @font-face y font-family, idéntico al de la aplicación y la línea de comandos.get_export: El mismo ajuste como variables CSS, Tailwind, Next.js, Nuxt, Astro, theme.json de WordPress, Fontaine, etiquetas preload o un script de carga, con un nombre de archivo sugerido.
Todas las herramientas salvo analyze_font aceptan de uno a 16 archivos de fuentes (WOFF2, WOFF, TTF u OTF, hasta 10 MB cada uno) y las mismas opciones que la línea de comandos: audience (una consulta de Browserslist), systems, locale, kind, unicode_range y scripts. La poca coincidencia de glifos y los sistemas sin fuentes alternativas llegan como avisos tras el resultado.
Configuración
Añade el servidor a tu cliente MCP. Se inicia con npx y requiere Node.js 24.21 o posterior.
claude mcp add fontstay -- npx -y fontstay mcpArchivo de configuración: claude_desktop_config.json
{
"mcpServers": {
"fontstay": { "command": "npx", "args": ["-y", "fontstay", "mcp"] }
}
}Archivo de configuración: .cursor/mcp.json
{
"mcpServers": {
"fontstay": { "command": "npx", "args": ["-y", "fontstay", "mcp"] }
}
}Archivo de configuración: .vscode/mcp.json
{
"servers": {
"fontstay": { "type": "stdio", "command": "npx", "args": ["-y", "fontstay", "mcp"] }
}
}Archivo de configuración: ~/.codex/config.toml
[mcp_servers.fontstay]
command = "npx"
args = ["-y", "fontstay", "mcp"]Si el paquete aún no está en npm, compílalo en un clon del repositorio con pnpm cli:build y usa node /path/to/packages/fontstay/dist/bin.js mcp como comando en lugar de npx. Las rutas relativas de fuentes se resuelven desde el directorio en el que el editor inicia el servidor.
Ejemplos de peticiones
Pregunta con lenguaje natural; el agente elige las herramientas.
- Analiza fonts/Inter.woff2 y dime qué escrituras cubre.
- Escribe el CSS de fuentes alternativas de fonts/Inter.woff2 para usuarios de Windows y macOS y añádelo a src/styles/fonts.css.
- Genera el tema de Tailwind para mis archivos de Fira Sans y revisa los avisos.
Resultado de muestra
Una llamada a get_css para tests/fixtures/fonts/FiraSans-Regular.ttf, limitada a Windows y macOS, sin caras adicionales para otras escrituras.
Llamada a la herramienta
{
"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;
}Límites
Una entrada incorrecta vuelve como error de la herramienta que el agente puede leer y corregir.
- Se rechazan las consultas de audiencia que cargan una configuración compartida o un archivo de estadísticas (extends, in package).
- No se leen las rutas de red de Windows (\\host\share).
- El desplazamiento de diseño necesita un navegador y no está disponible; usa la aplicación.
- El servidor habla las versiones 2025-11-25, 2025-06-18, 2025-03-26 y 2024-11-05 del protocolo MCP, solo herramientas.
El mismo motor está disponible como herramienta de línea de comandos y biblioteca de Node en el paquete fontstay. CLI y biblioteca para Node