Basalt

io.github.basalt-run由 GitHub 帳號 basalt-run 發布v1.0.0更新於 Oct 27, 2026

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

已驗證SSE可網頁執行開發者工具媒體與設計

概覽

AI 產生的概覽

Basalt 透過遠端 MCP 端點，把存放在 Git 中的設計系統（設計權杖、元件、圖示與無障礙資料）提供給 AI 程式開發工具使用。

可以做什麼
  • 查詢以 DTCG 格式儲存的設計權杖，涵蓋基礎層、語意層與元件層
  • 解析權杖之間的參照鏈，讓助理使用真實數值而非憑空猜測
  • 查找設計系統中的元件、圖示與無障礙資料
  • 在 Cursor、Claude Code、Windsurf 等工具中撰寫介面程式碼時直接使用這些結果
適用情境
當助理需要針對特定設計系統撰寫或修改前端程式碼，且需要專案真實的權杖名稱與數值、元件定義或無障礙資料，而不是自行編造時，適合使用。
執行需求
需要一個位於 basalt.run 的遠端 MCP 端點（透過 SSE 連線），並在 Authorization 標頭中攜帶 Basalt API 金鑰（可在服務設定中取得免費金鑰）。不需在本機安裝套件或執行環境。
安裝前請注意
連線需要在 Authorization 標頭中傳送 Basalt API 金鑰，應視為機密，避免分享含有該金鑰的設定。設計系統內容由 Basalt 代管服務提供，因此權杖與元件資料會傳送給該第三方。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Basalt，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 SSE。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.basalt-run%2Fbasalt/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "basalt": {
      "type": "sse",
      "url": "https://basalt.run/api/mcp"
    }
  }
}

README

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):

json
{  "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.

Links

License

MIT — see LICENSE.

來源：README.md，提交 353da52

工具

0
SourceWeft 尚未讀取此伺服器的工具。

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分