# melta UI

> melta UI is an open-source MCP server for design and media. Design-system tokens, component contracts and rule checks that keep AI-built UI on spec. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://melta.tsubotax.com
- **Repository:** https://github.com/tsubotax/melta-ui
- **MCP Registry name:** io.github.tsubotax/melta-ui
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-15

## About

melta UI treats a design system as something to enforce, not just document. The README says an AI can be told to read guidelines but may not follow them, so melta places a machine at four points: before generation (the MCP server supplies contracts), right after (lint or hooks reject violations), before merge (CI blocks) and afterwards (drift checks).

The package melta-ds-mcp is a stdio server plus a lint engine. Its check_html tool uses the same logic as CI and hooks. The system ships 101 tokens, 28 component contracts and 107 prohibited-pattern rules; 49 of those rules are detected automatically, and the rest are classified by why they are not. Tests use Playwright and axe-core.

It assumes Tailwind CSS class-based styling and Node 22 or newer, and it is not a ready-to-import component library. It is MIT licensed, with a React Native implementation published separately.

## Features

- **Token lookup:** Search design tokens and fetch component contracts through MCP.
- **HTML self-check:** check_html runs the same lint as CI and hooks.
- **107 prohibited rules:** A machine-readable registry of things not to do, with automation status.
- **Drift detection:** Flags documentation and implementation falling out of sync.
- **Layered loading:** DESIGN.md first, deeper contracts only when needed, to save context.
- **Bring your own system:** The server can load another design system's asset root.

## Good for

- Make Claude Code or Cursor generate Tailwind UI that follows your tokens
- Fail CI when generated markup breaks a design rule
- Share one design contract between web and React Native
- Check whether docs and implementation have drifted
- Start a design-system contract from a minimal four-file bundle

## Install

### Claude Code (Terminal)

```sh
claude mcp add melta-ui -- npx -y melta-ds-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "melta-ui": {
      "command": "npx",
      "args": [
        "-y",
        "melta-ds-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "melta-ui": {
      "command": "npx",
      "args": [
        "-y",
        "melta-ds-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "melta-ui": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "melta-ds-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "melta-ui": {
      "command": "npx",
      "args": [
        "-y",
        "melta-ds-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "melta-ui": {
      "command": "npx",
      "args": [
        "-y",
        "melta-ds-mcp"
      ]
    }
  }
}
```

## Tools

- `get_token`: Look up a design token.
- `get_component`: Fetch a component contract.
- `check_rule`: Check a rule from the registry.
- `check_html`: Self-verify generated HTML with the same logic as CI and hooks.

## FAQ

### Is it a component library?

No. It supplies tokens, rules, contracts and validators; web UI is a reference in HTML plus Tailwind classes.

### What are the requirements?

Node 22 or newer and Tailwind class-based styling.

### How do I add it to Claude Code?

Run claude mcp add melta-ui -- npx -y melta-ds-mcp.

### What licence?

MIT.

### Is melta UI free?

Yes. melta UI is open source, so you can use and self-host it for free.

### How do I add melta UI to Claude Code?

Run this command in your terminal: claude mcp add melta-ui -- npx -y melta-ds-mcp

### What are the best alternatives to melta UI?

The closest alternatives to melta UI are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/melta-ui
