Overture

项目定位#

Overture 是一个面向 AI 编码代理（如 Claude Code、Cursor、Cline、Copilot）的可视化计划执行与审批工作流工具。它作为本地 MCP (Model Context Protocol) 服务器运行，在代理开始编写代码前，将执行计划渲染为交互式流程图供用户审查与批准。

核心能力#

可视化交互#

• 交互式流程图：将 AI 代理的执行计划渲染为节点图形，清晰展示步骤间关系与分支路径
• 节点详情查看：点击任意节点查看该步骤的完整上下文与指令
• 决策路径选择：当代理提出多种解决方案时，用户可手动选择执行路径

执行控制#

• 预审批机制：代理在用户批准计划前被阻塞，不会编写任何代码
• 上下文附加：为特定步骤附加文件、文档、API 密钥和指令等上下文信息
• 实时执行监控：节点实时显示活跃、完成或错误状态

系统集成#

• MCP 协议支持：作为 MCP Server 运行，兼容任何支持 MCP 的 AI 编码代理
• 本地优先：完全本地运行，数据不出本地，通过 localhost 提供服务
• WebSocket 通信：支持实时双向通信

解决的核心问题#

• 透明度不足：传统 AI 编码代理在写代码前不显示完整计划
• 误解成本高：发现代理误解需求时已写了大量代码需废弃
• 文本计划局限：文本计划无法展示步骤间关系、分支路径和上下文需求

安装部署#

快速启动#

# 使用 npx 直接运行（无需安装）
npx overture-mcp

全局安装#

npm install -g overture-mcp

针对不同 AI 代理的配置#

Claude Code

claude mcp add overture-mcp -- npx overture-mcp

Cursor 编辑 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"]
    }
  }
}

Cline (VS Code Extension)

{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"]
    }
  }
}

GitHub Copilot 在项目根目录创建 .vscode/mcp.json:

{
  "servers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"]
    }
  }
}

配置选项#

高级配置示例#

{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"],
      "env": {
        "OVERTURE_HTTP_PORT": "4000",
        "OVERTURE_WS_PORT": "4001",
        "OVERTURE_AUTO_OPEN": "false"
      }
    }
  }
}

工作流程#

1. 向 AI 代理提出任务（如 "Build a REST API with authentication"）
2. 代理生成详细计划，分解为多个步骤，包含分支路径
3. Overture 在浏览器中显示交互式图形计划
4. 用户审查并丰富计划（查看节点详情、附加上下文、选择决策路径）
5. 用户批准计划，代理开始执行
6. 实时观看进度，节点状态更新（活跃、完成、失败）

项目结构#

Overture/
├── packages/
│   ├── mcp-server/     # MCP 服务器实现
│   └── ui/             # Web UI 界面
├── examples/
│   └── ecommerce-plan.xml  # 示例计划文件
├── prompts/            # 提示词相关
└── assets/             # 资源文件

技术规格#

• 主要语言：TypeScript (82.1%), JavaScript (16.8%), HTML (1.1%)
• 协议：MCP (Model Context Protocol)
• 通信：WebSocket + HTTP
• 许可证：MIT License
• 开发组织：SixHq
• 当前版本：0.1.6