opencode-cli-mcp

# opencode-cli-mcp

MCP server wrapping [opencode](https://opencode.ai/) CLI into FastMCP tools with a FastAPI REST bridge and Vite/React dashboard. Enables AI agents to delegate implementation tasks to opencode.

> **Full reference**: [llms-full.txt](llms-full.txt) - tools, endpoints, env vars, architecture.

## Quick Start

```powershell
uv sync
uv run python -m api.main      # Backend :10951
cd web_sota && npm run dev     # Frontend :10950
opencode serve --port 4097     # opencode HTTP API (dedicated port, NOT 4096)
```

## Ports

- 10950 - Frontend (Vite React)
- 10951 - Backend (FastAPI REST + MCP HTTP /mcp)
- 4097 - opencode serve HTTP API (dedicated; the desktop app owns 4096)

## Architecture

MCP Clients → opencode-cli-mcp (stdio) → opencode serve (:4097) → opencode agent

## Key Files

- `src/opencode_cli_mcp/` - FastMCP server (4 primary + 16 legacy alias tools, single TOOL_REGISTRY)
- `api/main.py` - FastAPI REST bridge
- `api/routes/` - Capabilities, fleet, logs, proxy, settings, system, tools, chat, docs
- `web_sota/` - Vite/React/Tailwind dashboard

## Dependencies

- Python 3.12+, FastMCP 3.4.4+, FastAPI 0.115+, prefab-ui 0.14+
- Node 20+, Vite 5.4, React 18, TailwindCSS 3.4