MaaMCP_CC

專為 Claude Code 打造的 MaaFramework Pipeline 開發工具

這是什麼？

MaaMCP_CC 是一個 MCP (Model Context Protocol) 伺服器，讓 Claude Code 能夠直接操控 Android 模擬器或 Windows 視窗，專門優化 MaaFramework Pipeline 開發流程。

與 MaaMCP 的差異

Related MCP server: MaaMCP

安裝

前置需求

• Python 3.10 以上

• Claude Code CLI

步驟一：安裝套件

pip install maamcp-cc

步驟二：在你的 MaaFramework 專案中加入 MCP 設定

在專案根目錄建立 .mcp.json：

{
  "mcpServers": {
    "MaaMCP_CC": {
      "command": "maamcp-cc"
    }
  }
}

用 Claude Code 開啟專案資料夾，會自動偵測 .mcp.json 並詢問是否啟用。

步驟三：確認安裝成功

claude mcp list

看到 MaaMCP_CC: ... ✓ Connected 即為成功。

工具一覽

設備管理

畫面觀察

開發輔助

裝置操作

任務執行

開發工作流程

1. list_devices              → 查看有哪些設備
2. connect_adb / window      → 連接設備 + 載入資源
3. screenshot_with_grid      → 帶格線截圖，確定 UI 元素座標
4. crop_template             → 裁切模板圖（自動產生 pipeline 用法）
5. test_recognition          → 即時測試識別條件（可重複調整）
6. 修改 Pipeline JSON
7. reload_resource           → 熱重載修改後的資源
8. run_task                  → 驗證結果

Token 管理策略

圖片會消耗較多 token，可依情況選擇：

圖片已自動壓縮（縮放至 960px + JPEG 60% 品質）。

重點工具詳解

screenshot_with_grid

在截圖上疊加座標格線，讓 Claude 能精確讀出每個 UI 元素的座標。

screenshot_with_grid(grid_step=100)

搭配 crop_template 使用：先看格線確定座標 → 裁切模板。

crop_template

從截圖裁切一塊區域作為模板圖，自動儲存到資源包的 image/ 目錄。

crop_template(x=1150, y=25, width=80, height=30, save_name="skip_button.png")

回傳值直接包含可貼進 Pipeline JSON 的識別定義：

{
  "recognition": "TemplateMatch",
  "template": ["skip_button.png"],
  "roi": [1150, 25, 80, 30]
}

預設使用上一次截圖的快取（與 screenshot_with_grid 看到的是同一張），設定 new_screenshot=True 可拍新的。

test_recognition

即時測試識別節點，不需要寫入任何 Pipeline 檔案。

OCR 範例：

{
  "recognition_type": "OCR",
  "params": { "expected": ["確認", "OK"], "roi": [500, 600, 400, 100] }
}

TemplateMatch 範例：

{
  "recognition_type": "TemplateMatch",
  "params": { "template": ["skip_button.png"], "threshold": [0.8] }
}

回傳標記了命中位置的截圖（命中為綠框，未命中顯示 MISS）。

reload_resource

修改 Pipeline JSON 或新增模板圖片後，呼叫即可生效，不需要重新連接設備。

技術細節

• 語言：Python 3.10+

• 依賴：FastMCP、MaaFw、OpenCV

• 授權：MIT

相關專案

• MaaFramework — 底層自動化框架

• MaaMCP — 原版 MCP（適合 Cursor 等工具）