io.github.ECD5A/orchestrui MCP Server

Orchestrui provides deterministic UI policy, discovery, and audits for coding agents across seven ecosystems. Its focus is on deterministic behavior, structured host inspection, smallest UI stack routing, role ownership harmonization, and audit of verified evidence. The project is positioned as an MCP server and is documented in a repository excerpt.

🛠️ Key Features

Deterministic UI policy
Discovery
Audits for coding agents across seven ecosystems
Evidence-audit oriented workflow
UI trace inspection and routing of structured UI stacks

🚀 Use Cases

Coding agent workflows that need deterministic UI behavior
Inspecting structured hosts and routing minimal UI stacks
Auditing verified evidence produced by agents
Cross-ecosystem agent integration (seven ecosystems)

⚡ Developer Benefits

Deterministic UI policy and quality gates
Structured UI trace for inspection
Clear alignment around role ownership harmonization

⚠️ Limitations

Only the described capabilities are documented in the provided excerpt; tool coverage and specific MCP endpoints are not included.

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

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:

json

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

Install skills on macOS / Linux

bash

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

Install skills on Windows

powershell

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

Develop from source

bash

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:

text

$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

json

{
  "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:

Email Telegram GitHub repository

OrchestrUI