opencode-cli-mcp MCP 服务说明文档

1. 服务概述一句话简介将opencode CLI的HTTP API封装为MCP工具并提供SOTA fleet标准的Web仪表板。服务名称opencode-cli-mcp版本号1.0.0开发者/提供方sandraschi协议类型MCP (Model Context Protocol)2. 核心功能该MCP服务提供以下主要功能Agent运行非交互式运行agent并执行提示会话管理列出、获取、导出活动/最近的会话消息交互向运行中的会话发送消息检索会话记录服务器状态检查服务器健康状态提供商管理列出配置的LLM提供商项目上下文获取当前项目上下文3. 使用场景该服务适合在以下情况下使用通过MCP协议调用opencode CLI功能管理AI代理会话和工作流集成opencode到其他MCP兼容客户端监控和管理代理集群4. 接入方式4.1 架构Clients (MCP hosts) → opencode-cli-mcp (FastMCP 3.2) ↕ HTTP opencode serve (port 4096)4.2 端口配置端口服务10950前端 (Vite)10951后端 (FastAPI)4096opencode serve4.3 服务器配置快速启动.\start.ps1或分别运行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)5. 接口定义工具名称描述opencode_run_agent非交互式运行agent并执行提示opencode_list_sessions列出所有活动/最近的会话opencode_get_session获取详细的会话信息opencode_export_session将会话导出为JSONopencode_send_message向运行中的会话发送消息opencode_get_messages检索会话记录opencode_server_status检查服务器健康状态opencode_list_providers列出配置的LLM提供商opencode_get_project获取当前项目上下文6. 快速开始6.1 环境要求opencode — npm i -g opencode-aiPython 3.12 with uvNode.js 18 with npm6.2 安装步骤npm i -g opencode-ai git clone repository cd opencode-cli-mcp uv sync7. 注意事项需要先安装opencode CLI工具MCP服务器使用stdio传输方式FastAPI桥接用于Web应用和能力内省许可证MIT