Isabyte MCP Server

An Isabyte expert, packaged as a Docker image

The Isabyte MCP Server bakes the entire Isabyte skill corpus into a lightweight Linux image (~50 MB) and exposes it over the Model Context Protocol's Streamable-HTTP transport. Connect Claude Desktop, Cline, Cursor, Continue, or any other MCP client and your AI assistant becomes an Isabyte specialist with grounded knowledge of every component, parameter, and pattern.

Download the MCP Server

📦

What's inside

Each release ships an MCP server with the complete Isabyte skill corpus baked in — both component-reference skills and the whole-app scaffolding skills:

Component reference

🎛️ isabyte-controls.md

Every form control (CheckBox, Dropdown, Slider, …) plus IsabyteRootComponent and the cascading error system.

📊 isabyte-charts.md

The full 15-chart family (Bar, Line, Pie, Donut, Scatter, Bubble, Radar, Polar, TreeMap, Funnel, Histogram, BoxWhisker, Bullet, DateAxis, Trendline) with tooltips, palettes, 3D & responsive sizing.

🎨 isabyte-images-animation.md

Image, AnimationEffect, Background, Carousel, ObjectDetector.

🛠️ isabyte-tools.md

ServerMonitor, TerminalClient, ThemeBuilder, LandingPage, ImageEditor, and the IsabyteAppFramework responsive shell.

🔍 isabyte-devtools.md

Render diagnostics, browser size, element tracking.

🧠 isabyte-ai.md

Speech, transcription, text generation, the reusable IsabyteAiChatPanel.

🖼️ isabyte-image-editor.md

The full IsabyteImageEditor reference — 25+ tools, layer system, 85+ JS API functions.

📰 isabyte-landing-page.md

The IsabyteLandingPage visual builder — Edit/Preview modes, multi-page projects, element catalog.

Whole-app scaffolding — the design system

🧭 isabyte-design-system.md

The "design my app with Isabyte" wizard — 9-question interview, implementation plan, dry-run preview. See the walkthrough →

📋 isabyte-implementation-plan.md

The 10-section runbook the wizard follows — written to .claude/plans/isabyte-scaffold.md for review before any file is created.

How to run

Download the zip above and extract it.
Load the image into your local Docker engine:
```
cd isabyte-mcp-server-<version>
bash load.sh
```

Start the server:

docker run --rm -p 7180:7180 isabyte-mcp-server:<version>

Verify it's healthy: curl http://localhost:7180/health should return {"status":"ok","skills":11} (10 skill files plus the index).
Connect any MCP client to http://localhost:7180/mcp (see the snippets below).

MCP client configuration

Claude Desktop / Cline / Cursor / Continue

Add an entry to your client's MCP config:

{
  "mcpServers": {
    "isabyte-expert": {
      "url": "http://localhost:7180/mcp",
      "transport": "http"
    }
  }
}

Once connected, your assistant has full access to:

Every Isabyte skill as an MCP resource (URI scheme isabyte-skill://)
The isabyte_expert_guidance prompt, which injects every skill as grounding context for any Isabyte question

Smoke test with the official MCP Inspector

npx @modelcontextprotocol/inspector

Connect the inspector to http://localhost:7180/mcp. The Resources tab should list every skill file; the Prompts tab should show isabyte_expert_guidance.

Security

By default, the server binds to 0.0.0.0 with no auth — fine for a developer running it locally on a single workstation. If the container is reachable beyond localhost:

Bind to localhost only: -p 127.0.0.1:7180:7180
Or require a bearer token: -e MCP_AUTH_TOKEN="$(openssl rand -hex 24)" and add "headers": { "Authorization": "Bearer YOUR_TOKEN" } to your client config.

🧭

New here? See it in action first

Developing with the Isabyte MCP Server walks through the “design my app with Isabyte” wizard end to end — the 9 questions, a real worked example with its answers, the exact file tree it plans, and the patterns & best practices you get. See precisely what lands in your project before you connect a single client.

Read the walkthrough →