Skip to content
MCP server

onsystem

Flags hardcoded colours and unknown components in agent-written React UI code

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, vscode, self-hosted
Runs
Locally
Version
0.12.1
Listing updated
3 days ago

About onsystem

onsystem is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Coding agents write UI from training data, so a settings card tends to arrive with bg-[#ef4444], p-[13px], a native button and a variant your Button never had. onsystem reads your design-system package with the TypeScript compiler and checks the agent's .tsx and .jsx output against what actually exists.

Its MCP server shows the agent your components, cva and tv variants, parts and tokens before it writes, and a check_ui call returns findings with a rule id, a location and a fix. Rules named on the site include no-hardcoded-color, no-hardcoded-spacing, no-unknown-component, no-unknown-prop, no-unknown-variant, icon-button-accessible-name and prefer-design-system-component. Tokens can come from stylesheets, DTCG files or a DESIGN.md.

Checks run locally with no model calls; the site cites 1.8 ms on its demo file. A Claude Code plugin adds a hook that checks every edit, and a GitHub Action checks only the lines a pull request changes. Setup is done once in the design-system package so each app in a monorepo inherits it. It works with shadcn/ui, a custom package or MUI.

Install

Run in a terminal

claude mcp add onsystem -- npx -y onsystem

Add to claude_desktop_config.json

{
  "mcpServers": {
    "onsystem": {
      "command": "npx",
      "args": [
        "-y",
        "onsystem"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "onsystem": {
      "command": "npx",
      "args": [
        "-y",
        "onsystem"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "onsystem": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "onsystem"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "onsystem": {
      "command": "npx",
      "args": [
        "-y",
        "onsystem"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "onsystem": {
      "command": "npx",
      "args": [
        "-y",
        "onsystem"
      ]
    }
  }
}

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

check_ui
Check a file against the design system and return findings with fixes

What it does

check_ui tool
Returns findings with a rule id, location and suggested fix for a file.
Design-system lookup
Shows the agent your components, variants, parts and tokens before it writes UI.
Edit-time hook
The Claude Code plugin checks each edit the agent makes.
Pull request check
A GitHub Action checks only changed lines and fails on errors.
Token sources
Reads stylesheets, DTCG files or a DESIGN.md, and can export tokens back out.
Runs locally
No model calls; the check is a local static analysis.

Good for

  • Stop agents from writing hex colours and arbitrary spacing in React components
  • Catch invented variants or props before review
  • Enforce a shared design system across every app in a monorepo
  • Fail a pull request when agent-written UI bypasses the design system

Pricing

Open source

Free; runs locally. A licence badge is shown in the README.

Prices change. Check onsystem.vercel.app before you buy.

onsystem FAQ

Does it send my code to a model?

No. The site says it runs locally with no model calls.

Which design systems does it support?

The site names shadcn/ui, your own package or MUI.

How do I install it?

Run npx -y onsystem as a stdio server, or install the Claude Code plugin from the dgesteves marketplace.

Can it run in CI?

Yes, through the dgesteves/onsystem GitHub Action, which checks the lines a pull request changes.

Is onsystem free?

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

How do I add onsystem to Claude Code?

Run this command in your terminal: claude mcp add onsystem -- npx -y onsystem

What are the best alternatives to onsystem?

The closest alternatives to onsystem are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to onsystem

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools