eds-mcp-server — the Edwson Design System over MCP

A read-only Model Context Protocol server that hands your design-system token + component contract to any AI agent (Claude Code, Codex, Cursor, …) as callable tools — so the whole org builds UI from one source of truth, the system auto-syncs, and your AI-token bill goes down instead of up.

This is the runnable backbone behind the "AI-Native Development" section of the design system showcase.

Why an enterprise adopts this (and doesn't leave)

1 · It cuts your AI-token spend. The expensive way teams use AI for UI today: paste a 6–15 KB CSS/theme file plus a screenshot or two into the agent every turn, let it regenerate full hex/CSS, and correct it 2–3 times. That's ~10K+ input tokens × several loops per component.

This server instead serves targeted, reference-based, cache-friendly slices:

2 · It auto-syncs across the org. build-manifest.js hashes every contract file into manifest.json (version + per-file SHA-256). Consumers compare their cached manifest and pull only the changed files (diff_since). A token change propagates everywhere — apps (build), Storybook (docs), agents (MCP) — without a rebuild, because everything references tokens, never literals.

3 · It enforces consistency + compliance. One signed manifest = one source of truth; checksums prevent drift; SemVer gates breaking changes. Regulated components (risk warnings, KYC gates, sign-off bars) carry their rule in the contract and are marked non-removable, so neither a human in a hurry nor an agent can ship the surface without them.

Related MCP server: my-design MCP Server

Tools (all read-only)

Run

npm install
npm run build:manifest   # regenerate manifest.json after any token/component change
npm start                # speaks MCP over stdio

Register with an MCP client (example for Claude Code / Cursor mcp.json):

{ "mcpServers": { "eds": { "command": "node", "args": ["server.js"], "cwd": "./eds-mcp" } } }

Requires Node 18+. The contract lives in tokens.json + components.json; edit those, re-run build:manifest, and every consumer picks up the delta.

Files

tokens.json        token contract (color light/dark, space, radius, type, density)
components.json    component contracts (purpose, when-to-use/not, props, a11y, regulatory, dataContract)
build-manifest.js  auto-sync engine — hashes contracts -> manifest.json
server.js          MCP server — read-only tools over stdio
manifest.json      generated — version + SHA-256 per file