Barrhawk Premium E2e MCP

🚀 BARRHAWK：驗證你的VIBECODE

BARRHAWK是用於智能體驗證與編排的操作系統，它提供了一套完整的解決方案，可實現自動化測試和驗證流程，幫助開發者更高效地進行軟件測試和質量保證。

██████╗  █████╗ ██████╗ ██████╗ ██╗  ██╗ █████╗ ██╗    ██╗██╗  ██╗
██╔══██╗██╔══██╗██╔══██╗██╔══██╗██║  ██║██╔══██╗██║    ██║██║ ██╔╝
██████╔╝███████║██████╔╝██████╔╝███████║███████║██║ █╗ ██║█████╔╝
██╔══██╗██╔══██║██╔══██╗██╔══██╗██╔══██║██╔══██║██║███╗██║██╔═██╗
██████╔╝██║  ██║██║  ██║██║  ██║██║  ██║██║  ██║╚███╔███╔╝██║  ██╗
╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝ ╚══╝╚══╝ ╚═╝  ╚═╝
                                            v0.5.0 | 三方版本發佈

“如果你的智能體無法自我測試，那它只是一場幻覺。”

🚀 快速開始

克隆並安裝

git clone git@github.com:barrhawk/barrhawk_premium_e2e_mcp.git
cd barrhawk_premium_e2e_mcp
bun install

啟動棧

bun run barrhawk

提交測試

curl -X POST http://localhost:7001/plan \
  -H "Content-Type: application/json" \
  -d '{"intent":"take a screenshot of the homepage","url":"https://example.com"}'

棧模式

bun run barrhawk           # 完整三方棧 (Bridge, Doctor, Igor, Frank)
bun run barrhawk --minimal # 僅 Bridge + Igor (輕量級)
bun run barrhawk --hub     # 完整棧 + 測試編排中心

✨ 主要特性

v0.5.0 新特性

• 統一棧：單個命令 bun run barrhawk 啟動所有服務。
• 集成儀表盤：可在 http://localhost:7000/dashboard 進行即時監控。
• 經驗系統：跨會話學習的自修複選擇器。
• 工具注入：新工具即時廣播到運行中的Igor。
• 閃電打擊：Igor在遇到困難時自動升級到Claude進行推理。
• 中心模式：使用 --hub 標誌進行多Igor測試編排。

📚 詳細文檔

三方架構

四個專門的服務器通過WebSocket進行通信：

工作原理

1. 你 向Doctor發送意圖："test the login flow"
2. Doctor 參考經驗，生成計劃並選擇工具
3. Igor 逐步執行計劃
4. Frankenstein 控制瀏覽器並截圖
5. 經驗系統 記錄成功經驗供下次使用

閃電打擊（雙模式Igor）

Igor從“傻瓜模式”開始 - 基於正則表達式的快速執行。當一個步驟失敗3次時，Igor會“打擊” - 提升到完整的Claude推理來解決問題，然後再恢復到正常模式。

端點

Doctor（端口7001）

# 提交計劃
POST /plan
{"intent": "click the login button", "url": "https://example.com"}

# 檢查計劃狀態
GET /plans
GET /plans/:id

Bridge（端口7000）

# 健康檢查
GET /health

# 即時儀表盤
GET /dashboard

Igor（端口7002）

# 狀態
GET /status
GET /health

# 當前工具包
GET /toolbag

Frankenstein（端口7003）

# 健康和工具
GET /health
GET /tools

項目結構

/
├── bin/barrhawk.ts          # CLI入口點
├── tripartite/              # 核心棧
│   ├── bridge/              # 消息總線 + 儀表盤 (7000)
│   ├── doctor/              # 規劃器 + 群體邏輯 (7001)
│   ├── igor/                # 執行器 + 閃電打擊 (7002)
│   ├── frankenstein/        # 瀏覽器 + 工具鍛造 (7003)
│   └── shared/              # 通用工具
│       ├── experience.ts    # 學習系統
│       ├── tool-registry.ts # 120+ 工具定義
│       └── types.ts         # 共享類型
├── hub/                     # 測試編排 (--hub模式)
│   ├── index.ts             # 中心API (7010)
│   ├── coordinator.ts       # 多Igor同步 (7011)
│   └── igor-db.ts           # 數據庫監控器 (7012)
├── packages/                # 功能模塊
│   ├── golden/              # 視覺迴歸
│   ├── self-heal/           # 選擇器策略
│   └── ...                  # 30+ 包
└── docs/                    # 文檔
    └── specs/               # 組件規格

MCP集成

BarrHawk為Claude Code、Cursor和其他AI助手提供MCP工具。

配置Claude Code

./scripts/generate-mcp-configs.sh

關鍵工具

// 自然語言自動化
frank_execute({ task: "Log into github.com", url: "https://github.com" })

// 並行測試
frank_swarm_execute({ intent: "Test checkout flow", maxIgors: 4 })

// 操作系統級控制 (擴展、對話框)
frank_os_mouse({ action: "click", x: 100, y: 200 })
frank_os_keyboard({ combo: "ctrl+shift+i" })

// 截圖
frank_screenshot({ fullPage: true })

經驗系統

BarrHawk從每次測試運行中學習：

• 選擇器：哪些CSS選擇器適用於哪些元素
• 時間：每個網站上操作通常所需的時間
• 錯誤：常見錯誤模式及其修復方法
• 網站：已知網站模式及預映射的選擇器

數據存儲在 experiencegained/experience.json 中（可通過 EXPERIENCE_DIR 配置）。

💻 使用示例

基礎用法

# 克隆並安裝項目
git clone git@github.com:barrhawk/barrhawk_premium_e2e_mcp.git
cd barrhawk_premium_e2e_mcp
bun install

# 啟動棧
bun run barrhawk

# 提交測試
curl -X POST http://localhost:7001/plan \
  -H "Content-Type: application/json" \
  -d '{"intent":"take a screenshot of the homepage","url":"https://example.com"}'

高級用法

// 並行測試示例
frank_swarm_execute({ intent: "Test checkout flow", maxIgors: 4 })

🔧 技術細節

開發

# 運行測試
bun test

# 類型檢查
bun run typecheck

# 查看日誌
tail -f /tmp/tripartite-*.log

📄 許可證

本項目採用MIT許可證。

“信任，但要驗證。” — BarrHawk