opencode-cli-mcp
MCP server that wraps opencode CLI's HTTP API (opencode serve) into MCP tools, plus a SOTA fleet webapp dashboard.
Architecture
Clients (MCP hosts) → opencode-cli-mcp (FastMCP 3.2)
↕ HTTP
opencode serve (port 4096)
- MCP Server (stdio): Exposes 9 tools for agent run, session management, and server status
- FastAPI Bridge (port 10951): REST API for the webapp + capability introspection
- Vite Webapp (port 10950): SOTA fleet-standard dashboard
Prerequisites
- opencode —
npm i -g opencode-ai - Python 3.12+ with
uv - Node.js 18+ with npm
Quick Start
.\start.ps1
This starts opencode serve, the API backend, and the webapp frontend.
Or run individually:
uv run -m opencode_cli_mcp.server # MCP server (stdio)
uv run -m api.main # API backend (port 10951)
cd web_sota && npm run dev # Frontend (port 10950)
MCP Tools
| Tool | Description |
|---|---|
opencode_run_agent |
Run an agent non-interactively with a prompt |
opencode_list_sessions |
List all active/recent sessions |
opencode_get_session |
Get detailed session info |
opencode_export_session |
Export session as JSON |
opencode_send_message |
Send message to a running session |
opencode_get_messages |
Retrieve session transcript |
opencode_server_status |
Check server health and status |
opencode_list_providers |
List configured LLM providers |
opencode_get_project |
Get current project context |
Ports
| Port | Service |
|---|---|
| 10950 | Frontend (Vite) |
| 10951 | Backend (FastAPI) |
| 4096 | opencode serve |
License
MIT
