Basalt
Servidor MCP de sistema de diseño: consulta tokens, componentes, iconos y datos de contraste WCAG desde sistemas de diseño respaldados por Git.
Documentación
Servidor MCP de Basalt
Conecta tus herramientas de codificación con IA a tu sistema de diseño. Basalt sirve tus design tokens, especificaciones de componentes, iconos y datos de accesibilidad a través de MCP para que las herramientas de IA generen código fiel a tu marca, no valores codificados.
Funciona con Claude Design, Claude Code, Cursor, Windsurf y cualquier cliente compatible con MCP.
Inicio rápido
1. Obtén una clave de API
Regístrate en basalt.run (gratis) y ve a Configuración → Claves de API → Generar nueva clave.
2. Añádelo a tu herramienta
Cursor — añádelo a ~/.cursor/mcp.json o en Configuración → MCP:
{
"mcpServers": {
"basalt": {
"url": "https://basalt.run/api/mcp",
"headers": {
"Authorization": "Bearer bsk_your_key_here"
}
}
}
}
Claude Code:
claude mcp add --transport http basalt https://basalt.run/api/mcp \
--header "Authorization: Bearer bsk_your_key_here"
Claude Desktop — añádelo a claude_desktop_config.json:
{
"mcpServers": {
"basalt": {
"url": "https://basalt.run/api/mcp",
"headers": {
"Authorization": "Bearer bsk_your_key_here"
}
}
}
}
Windsurf — Configuración → Servidores MCP, misma configuración que Cursor.
Herramientas disponibles
| Herramienta | Descripción |
|---|---|
get_token | Obtén un valor de token resuelto por ruta (p. ej. color.action.default) |
list_tokens | Lista todos los tokens de un proyecto |
search_tokens | Busca tokens por nombre o valor |
get_component | Obtén la especificación completa del componente: uso, variantes, notas de accesibilidad, código |
list_components | Lista todos los componentes registrados con metadatos |
get_icon | Obtén un icono SVG por nombre |
list_icons | Lista todos los iconos disponibles |
get_theme | Obtén los tokens de tema claro/oscuro |
check_contrast | Comprueba el contraste AA/AAA de WCAG entre dos colores |
Qué resuelve
Las herramientas de codificación con IA alucinan valores de diseño. Codifican #3B82F6 en lugar de usar var(--color-action-default). Adivinan las API de los componentes en lugar de usar tus props reales.
Basalt ofrece a las herramientas de IA una fuente de verdad estructurada y consultable para tu sistema de diseño. Los tokens se almacenan en Git como JSON DTCG 2025.10, se editan visualmente en el editor web de Basalt y se sirven a través de MCP.
Funciona con Claude Design
Claude Design lee tu código durante la incorporación para aplicar tu marca. Basalt es donde se define tu marca: tokens, componentes, documentación, todo en Git. Edita en Basalt, haz commit en tu repositorio, y Claude Design lo recoge automáticamente.
Enlaces
- Sitio web: basalt.run
- Formato de tokens: DTCG 2025.10 (estándar W3C)
- SDK: @modelcontextprotocol/sdk (Node.js)