Content
# base-ui-mcp
MCP server that gives AI assistants context about [Base UI](https://base-ui.com).
## Install
Claude Code:
```bash
claude mcp add base-ui -- npx -y base-ui-mcp
```
Codex CLI:
```bash
codex mcp add base-ui -- npx -y base-ui-mcp
```
Or add to `~/.codex/config.toml` (global) / `.codex/config.toml` (project):
```toml
[mcp_servers.base-ui]
command = "npx"
args = ["-y", "base-ui-mcp"]
```
Cursor — add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project):
```json
{
"mcpServers": {
"base-ui": {
"type": "stdio",
"command": "npx",
"args": ["-y", "base-ui-mcp"]
}
}
}
```
VS Code — add to `.vscode/mcp.json` (workspace) or run **MCP: Open User Configuration**:
```json
{
"servers": {
"base-ui": {
"type": "stdio",
"command": "npx",
"args": ["-y", "base-ui-mcp"]
}
}
}
```
opencode — add to `opencode.json`:
```json
{
"mcp": {
"base-ui": {
"type": "local",
"command": ["npx", "-y", "base-ui-mcp"],
"enabled": true
}
}
}
```
Prefer a different runner? Swap `npx -y base-ui-mcp` for:
| Runner | Command |
|---|---|
| npm | `npx -y base-ui-mcp` |
| pnpm | `pnpm dlx base-ui-mcp` |
| yarn | `yarn dlx base-ui-mcp` |
| bun | `bunx base-ui-mcp` |
For JSON/TOML configs, split the runner into `command` + `args` (e.g. `"command": "pnpm"`, `"args": ["dlx", "base-ui-mcp"]`).
Works with any MCP client via stdio.
## Tools
| Tool | Purpose |
|---|---|
| `list_components` | List all Base UI components by category |
| `search_components` | Keyword search |
| `get_component` | Full docs for one component |
| `get_component_example` | Extract code blocks by section/language |
| `get_install_instructions` | Install command + import snippet |
| `get_handbook_guide` | Fetch a handbook guide |
## License
MIT