Deterministic UI policy, discovery and audits for coding agents across seven ecosystems.

How do I install OrchestrUI?

Clone OrchestrUI from https://github.com/ECD5A/OrchestrUI and configure it as an MCP server in your client (Claude Desktop, Cursor, or VS Code).

Is OrchestrUI open source?

Yes, OrchestrUI is open source under the MIT license. Source code is available at https://github.com/ECD5A/OrchestrUI.

What category does OrchestrUI belong to?

OrchestrUI is listed under Other MCP servers on MCPFind.

OrchestrUI — MCP Server for Other

Русская версия

Animated OrchestrUI trace: inspect a structured host, route the smallest UI stack, harmonize role ownership, and audit verified evidence

Deterministic UI policy and quality gates for coding agents.

Quick start · Output · Skills & MCP · Ecosystems · Docs

OrchestrUI inspects a structured project profile, preserves compatible owners, and returns the smallest admissible UI composition with evidence for every decision.

Quick start

Requires Node.js 20+. Add the published read-only server to an MCP host:

{
  "mcpServers": {
    "orchestrui": {
      "command": "npx",
      "args": ["-y", "orchestrui@latest"]
    }
  }
}

Install skills on macOS / Linux

git clone --depth 1 https://github.com/ECD5A/OrchestrUI.git
cd OrchestrUI
bash scripts/install-codex.sh

Install skills on Windows

git clone --depth 1 https://github.com/ECD5A/OrchestrUI.git
Set-Location OrchestrUI
powershell -ExecutionPolicy Bypass -File scripts\install-codex.ps1

Develop from source

git clone https://github.com/ECD5A/OrchestrUI.git
cd OrchestrUI
npm ci && npm run check
npm run benchmark

Contributions are welcome — see CONTRIBUTING.md for the short path from fork to PR.

Use them from a frontend project:

$ui-library-router plan the smallest compatible UI stack.
$ui-orchestrator implement the approved plan.
$ui-quality-audit audit the rendered result.

What it returns

{
  "input_mode": "structured-profiles",
  "selected": ["bklit-ui"],
  "owners": {
    "base-system": "host:shadcn-ui",
    "data-visualization": "bklit-ui"
  },
  "rejected": [{ "id": "daisyui", "rule": "base-system-conflict" }]
}

The committed suite passes 50/50 structured scenarios, 8/8 independently specified adversarial goldens, and three project fixtures in CI.

Skills and MCP

ui-library-router — inspects the host and assigns role ownership.
ui-orchestrator — integrates approved pieces into one visual contract.
ui-quality-audit — checks coherence, accessibility, responsiveness, motion, performance, and licensing.
Read-only MCP — inspect_project, list_libraries, recommend_stack, get_library_guidance, search_components, get_install_instructions, and audit_plan.

Published through npm, the official MCP Registry, and versioned GitHub Releases. Local plugin configuration is in .mcp.json; setup, architecture, security, licensing, and contribution details live in docs/, SECURITY.md, THIRD_PARTY.md, and CONTRIBUTING.md.

The MCP surface is read-only and uses public upstream metadata; implementation code and third-party assets remain in the host project.

Ecosystems

Ecosystem	Role
Kokonut UI	selective React/shadcn product polish
React Bits	one signature creative effect
daisyUI	intentional Tailwind semantic base
Bklit UI	charts and data visualization
Anime.js	bespoke timeline, SVG, or scroll motion
Rive	licensed interactive vector/state-machine graphics
Magic UI	animated marketing enhancement

OrchestrUI is independent and is not affiliated with or endorsed by these upstream projects.

Support

If OrchestrUI helps your work, you can support its ongoing maintenance:

TON: pointoncurve.ton
Bitcoin (BTC): 1ECDSA1b4d5TcZHtqNpcxmY8pBH1GgHntN
USDT (TRC20): TUF4vPdB6QkjCvZq18rBL4Qj4dK5ihCN75

Contact

For questions about OrchestrUI, integration, consulting, or collaboration:

Set up in your AI client

AI clientOperating system

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json

{
  "mcpServers": {
    "io-github-ecd5a-orchestrui": {
      "command": "npx",
      "args": [
        "-y",
        "orchestrui"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Compatible MCP Clients

OrchestrUI works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.

Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.

VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.

Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.

Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

OrchestrUI