mcpField
B
basalt

basalt

远程服务
basalt.run媒体与设计128 周前更新
代码仓库访问官网

关于 basalt

basalt 是通过 MCP 向 AI 编码工具提供设计系统数据的平台，适合管理设计令牌、组件与文档的团队。令牌存储在 Git 中，并按原始值、语义和组件层级组织。

主要功能

  1. 01通过 MCP 提供设计令牌
  2. 02支持原始值、语义及组件层级
  3. 03令牌采用 DTCG 2025.10 格式
  4. 04在工具中解析完整令牌引用链
  5. 05在 Git 中管理设计系统数据

适用场景

  1. 01让编码工具查询实际令牌值
  2. 02在浅色与深色主题间复用语义令牌
  3. 03按 UI 组件查找对应设计令牌

MCP 相关

basalt 的 MCP 服务向 Cursor、Claude Code、Claude Design 和 Windsurf 提供设计系统数据。客户端可查询令牌，并解析其层级引用关系。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://basalt.run/api/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址
SSEhttps://basalt.run/api/mcp需要授权

工具

详细介绍

Basalt 设计系统

存储在 Git 中的设计令牌。AI 可读，编辑体验出色。

此仓库由 Basalt 管理。Basalt 是一个设计系统平台，可将令牌、组件和文档存储在 Git 中，并通过 MCP 提供给 AI 编码工具。

此仓库包含什么

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

所有令牌均采用 DTCG 2025.10 格式（W3C 标准）。

在 AI 工具中使用这些令牌

Basalt 通过 MCP 服务将此设计系统提供给 Cursor、Claude Code、Claude Design 和 Windsurf。AI 工具会查询实际的令牌值，而不是自行猜测。

设置说明和可用工具请参阅 MCP.md。

快速配置（Cursor / Claude Code / Windsurf）：

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

在 basalt.run 获取免费的 API 密钥。

令牌架构

分为三个层级，每个层级都引用上一级：

原始令牌 → 原始值（color.orange.500 = #F97316） 语义令牌 → 意图 + 主题（color.action.default → color.orange.500） 组件令牌 → 应用于特定 UI 元素（button.background.default → color.action.default）

AI 工具会通过 MCP 自动解析完整的引用链。

链接

  • basalt.run — 可视化编辑器、组件注册表、MCP 服务
  • MCP.md — MCP 服务文档和设置说明
  • MCP Registry — 搜索 basalt

许可证

MIT — 请参阅 LICENSE。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。