English Français العربية

io.github.basalt-run/basalt

Registre officiel Médias et design

Design tokens, components, icons, and a11y data via MCP. For Cursor, Claude, and Windsurf.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (sse)
Claude Code 
claude mcp add --transport sse basalt 'https://basalt.run/api/mcp' --header 'Authorization: <Basalt API key from https://basalt.run Settings>'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "basalt": {
            "type": "sse",
            "url": "https://basalt.run/api/mcp",
            "headers": {
                "Authorization": "<Basalt API key from https://basalt.run Settings>"
            }
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Basalt Design System
  2. What's in this repo
  3. Using these tokens with AI tools
  4. Token architecture
  5. Links
  6. License

Basalt Design System

Design tokens in Git. Readable by AI. Beautiful to edit.

This repo is managed by Basalt — a design system platform that stores tokens, components, and documentation in Git and serves them to AI coding tools via MCP.

What's in this repo

tokens/
├── primitives.json        # Raw values (colors, spacing, radii)
├── semantic.light.json    # Light theme semantic tokens
└── semantic.dark.json     # Dark theme semantic tokens

All tokens use the DTCG 2025.10 format (W3C standard).

Using these tokens with AI tools

Basalt serves this design system to Cursor, Claude Code, Claude Design, and Windsurf via an MCP server. AI tools query your real token values instead of guessing.

See MCP.md for setup instructions and available tools.

Quick config (Cursor / Claude Code / Windsurf):

{
  "mcpServers": {
    "basalt": {
      "url": "https://basalt.run/api/mcp",
      "headers": {
        "Authorization": "Bearer bsk_your_key_here"
      }
    }
  }
}

Get a free API key at basalt.run.

Token architecture

Three tiers, each referencing the layer above:

Primitive → raw values (color.orange.500 = #F97316) Semantic → intent + theming (color.action.default → color.orange.500) Component → scoped to UI elements (button.background.default → color.action.default)

AI tools resolve the full chain automatically via MCP.

License

MIT — see LICENSE.

Questions fréquentes

Qu'est-ce que io.github.basalt-run/basalt ?

Design tokens, components, icons, and a11y data via MCP. For Cursor, Claude, and Windsurf.

Comment installer io.github.basalt-run/basalt ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport sse basalt 'https://basalt.run/api/mcp' --header 'Authorization: <Basalt API key from https://basalt.run Settings>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.basalt-run/basalt ?

Oui. Il attend Authorization, à renseigner dans sa configuration.

io.github.basalt-run/basalt est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.basalt-run/basalt ?

Il est publié par basalt-run. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.