@llui/mcp

Model Context Protocol server for LLui. Exposes debug tools for LLM-assisted development.

pnpm add -D @llui/mcp

Usage

The MCP server auto-connects to running LLui apps via the vite-plugin's mcpPort bridge (default port 5200). No manual setup needed -- just enable the plugin and point your MCP client at the server.

// vite.config.ts -- MCP is enabled by default
import llui from '@llui/vite-plugin'
export default defineConfig({ plugins: [llui({ mcpPort: 5200 })] })

Tools

State Inspection

| Tool | Description | | ---------------- | ---------------------------------- | | get_state | Get current component state | | describe_state | Describe state shape and types | | search_state | Search state tree by path or value |

Messaging

| Tool | Description | | ------------------ | ---------------------------------------- | | send_message | Dispatch a message to the component | | validate_message | Check if a message matches the Msg union |

History and Replay

| Tool | Description | | --------------------- | -------------------------------------- | | get_message_history | List all dispatched messages | | export_trace | Export message trace for replayTrace | | replay_trace | Replay a trace and compare states |

Bindings and DOM

| Tool | Description | | ---------------- | ---------------------------------------------- | | get_bindings | List all active bindings and their masks | | why_did_update | Explain which state change triggered a binding | | trace_element | Trace a DOM element back to its binding |

Bitmask Debugging

| Tool | Description | | ------------- | -------------------------------------- | | decode_mask | Decode a bitmask into state path names | | mask_legend | Show the full bit-to-path mapping |

Snapshots

| Tool | Description | | ---------------- | ----------------------------------- | | snapshot_state | Save a named state snapshot | | restore_state | Restore a previously saved snapshot |

Multi-Mount

| Tool | Description | | ------------------ | ------------------------------------------ | | list_components | List all mounted component instances | | select_component | Select a component for subsequent commands |

License

MIT