/ 目錄 / 演練場 / Overture
● 社群 SixHq ⚡ 即開即用

Overture

作者 SixHq · SixHq/Overture

在程式碼撰寫前,以互動式流程圖的形式查看你的編碼代理人的計劃 — 在 React Flow 畫布上審批、暫停或重新導向節點。

Overture 是一個本地 MCP 伺服器 + 網路 UI,可攔截 AI 編碼代理人(Claude Code、Cursor、Cline、Copilot、Sixth)的規劃階段,並將其視覺化為圖形。新增輸入、分支備選方案、為每個節點附加工具,並且只有在計劃看起來正確時才讓代理人執行。

為什麼要用

核心特性

即時演示

實際使用效果

overture.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": [
        "-y",
        "Overture"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": [
        "-y",
        "Overture"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": [
        "-y",
        "Overture"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": [
        "-y",
        "Overture"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "overture",
      "command": "npx",
      "args": [
        "-y",
        "Overture"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "overture": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "Overture"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add overture -- npx -y Overture

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: Overture

在程式碼撰寫前在流程圖中審查你的代理人計劃

👤 任何在真實儲存庫上執行編碼代理人的人 ⏱ ~15 min beginner

何時使用: 你被代理人自信地撰寫 800 行錯誤程式碼所困擾 — 你想要一個把關機制。

前置條件
  • Claude Code 或等效的代理人 — claude.ai/code
步驟
  1. 安裝
    執行 claude mcp add overture-mcp -- npx overture-mcp 以將其接線到 Claude Code。✓ 已複製
    → Overture 網路 UI 可在顯示的 URL 上存取
  2. 要求功能;計劃在畫布中開啟
    實作一個驗証中介軟體。編碼前,使用 overture 產生計劃圖。✓ 已複製
    → 每個步驟的節點出現在 Overture UI 中
  3. 審批或重新導向節點
    節點 3 看起來不對 — 以評論「改用 ./lib/auth.ts 的現有中介軟體」拒絕✓ 已複製
    → 計劃重新生成;代理人只有在你按下審批後才能編碼

結果: 代理人撰寫你實際要求的程式碼 — 你在第 3 步(而非提交 3)捕捉到錯誤的假設。

注意事項
  • 畫布在大型功能上變得雜亂 — 將功能分解為子計劃;Overture 支援多專案索引標籤
搭配使用: claude-code

並排比較兩種實作方法

👤 在設計之間選擇的工程師 ⏱ ~20 min intermediate

何時使用: 你在兩種方法(Redis 快取與記憶體內)之間猶豫不決,並希望代理人規劃兩者。

步驟
  1. 要求兩個分支
    在兩個分支中規劃此快取功能:(A) Redis、(B) 記憶體內 LRU。顯示每個的優缺點。✓ 已複製
    → Overture 呈現兩個具有比較的分支
  2. 選擇並執行
    審批分支 B。只執行該路徑。✓ 已複製
    → 只有選定的分支執行

結果: 在替代方案之間做出知情決定,無需對兩者都提交程式碼。

將密鑰注入計劃節點而不提交

👤 任何編寫部署計劃指令碼的人 ⏱ ~10 min intermediate

何時使用: 一個步驟需要 API 金鑰;你想在執行時提供它,而不是在提示歷史記錄中。

步驟
  1. 將節點標記為需要密鑰
    部署節點需要 DEPLOY_TOKEN 作為密鑰輸入。暫停直到提供。✓ 已複製
    → Overture 顯示等待輸入的密鑰欄位
  2. 貼到 UI;節點解鎖
    (在 Overture UI 中)貼上權杖並點擊繼續✓ 已複製
    → 計劃繼續;密鑰不在聊天歷史記錄中

結果: 代理人執行特權步驟,無需密鑰洩漏到文字稿中。

組合

與其他 MCP 搭配,撬動十倍槓桿

overture + claude-code

使用 Overture 作為每個 Claude Code 任務的審批層

從現在開始,對於任何估計超過 30 分鐘的任務,在編碼前使用 overture 進行規劃。✓ 已複製
overture + vibe-check

規劃 → 合理性檢查 → 執行

Overture 產生計劃後,在我審批前對其執行 vibe_check。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
plan_create goal: str, context?: str 任何多步驟編碼任務的開始 規劃的 LLM tokens
plan_update plan_id, node_changes 回應使用者審批/拒絕 0
plan_execute plan_id, from_node? 使用者審批後 工具呼叫 + tokens
plan_branch plan_id, from_node, alt_goal 比較替代方案 LLM tokens

成本與限制

運行它的成本

API 配額
無 — 本地應用程式
每次呼叫 Token 數
規劃預先新增約 1-3k tokens;避免錯誤程式碼可節省更多
費用
免費、開源
提示
僅對非平凡功能使用計劃;平凡編輯不需要圖表

安全

權限、密鑰、影響範圍

憑證儲存: 在 UI 中輸入的密鑰,每個計劃儲存在本地瀏覽器儲存空間中
資料出站: 預設無 — 在 localhost 上執行

故障排查

常見錯誤與修復

畫布 URL 傳回 ERR_CONNECTION_REFUSED

Overture UI 連接埠(預設 3939)未繫結;檢查 MCP 伺服器日誌或設定 OVERTURE_PORT

驗證: curl http://localhost:3939
計劃生成掛起

你的代理人在等待 LLM;檢查代理人自己的日誌以了解速率限制/token 耗盡

節點拒絕不生效

某些代理人會快取計劃 — 明確說「使用我的反饋從節點 X 重新生成計劃」

替代方案

Overture 對比其他方案

替代方案何時用它替代權衡
sequentialthinking-tools你想要文字計劃,而不是畫布沒有分支的視覺比較
shrimp-task-manager你想要持續任務,而不是互動式審批不同的迴圈 — 更多非同步,更少把關

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills