@donghao1980/autogo-mcp

v0.3.6

Published

11 days ago

MCP server for AutoGo and ADB workflows - 40 tools for Android/iOS automation

0High
0Medium
0Low

donghao1980

mcp autogo adb android ios ocr yolo opencv automation

AutoGo MCP

AutoGo MCP 是一个基于 stdio 的 MCP Server，将 AutoGo SDK 的强大功能暴露给支持 MCP 的客户端，提供完整的 Android/iOS 自动化能力。

✨ 功能特性

🔧 项目管理

run_project - 运行 AutoGo 项目到指定设备，支持调试模式
stop_project - 停止设备上的 AutoGo 项目
sync_files - 同步项目中的 so 和 assets 到设备

📱 设备管理

list_devices - 列出当前可见的 ADB 设备
connect_device - 连接远程 ADB 设备
adb_command - 执行自定义 ADB 命令

📲 应用管理

app_current_package - 获取当前页面的应用包名
app_current_activity - 获取当前页面的 Activity 名称
app_launch - 启动应用，支持"包名/类名"格式
app_get_list - 获取手机中所有应用列表
app_get_name - 获取应用名称
app_get_version - 获取应用版本号
app_is_installed - 判断应用是否已安装
app_install - 安装应用（支持 APK/XAPK）
app_uninstall - 卸载应用
app_force_stop - 强制停止应用

🖼️ 图色操作

capture_screen - 截取设备屏幕，支持保存到设备或下载到本地
get_pixel_color - 获取指定坐标的像素颜色值
find_color - 在屏幕上查找指定颜色的位置
compare_color - 比较指定位置的颜色是否匹配
find_multi_colors - 多点找色，精确定位目标
compare_multi_colors - 多点比色，验证位置颜色
find_multi_colors_all - 查找所有匹配的多点颜色位置

📝 OCR 文字识别

ocr_screen - 对整个屏幕进行 OCR 文字识别
ocr_region - 对屏幕指定区域进行 OCR 文字识别
ocr_image - 对设备上的图片文件进行 OCR 文字识别
ocr_detect - 检测屏幕上的文字区域位置
ocr_detect_region - 检测指定区域内的文字位置
ocr_find_text - 在屏幕上查找指定文字的位置

🎯 YOLO 目标检测

yolo_detect - 对整个屏幕进行目标检测
yolo_detect_region - 对屏幕指定区域进行目标检测
yolo_detect_image - 对设备上的图片文件进行目标检测
yolo_find_object - 在屏幕上查找指定类别的目标
yolo_count_objects - 统计屏幕上各类目标的数量

🖼️ OpenCV 图像处理

opencv_match_template - 模板匹配查找图片

🎬 Motion 运动检测

当前版本暂未启用，后续版本开放。

📋 UI 节点操作

get_screen_nodes - 抓取当前屏幕节点树并按条件过滤

📊 日志管理

read_project_logs - 读取运行会话的增量日志

📦 环境要求

Node.js 18 及以上
AutoGo SDK
ADB（可选；如果 PATH 中没有，需要显式指定）

🚀 安装与使用

推荐直接通过 npx 启动：

npx -y @donghao1980/autogo-mcp

⚙️ 环境变量

| 变量名 | 说明 | 默认值 | |--------|------|--------| | AUTOGO_AG_PATH | AutoGo SDK 路径 | Windows: C:\Users\Public\ag.exemacOS: /Users/Shared/ag | | AUTOGO_ADB_PATH | ADB 可执行文件路径 | - | | AUTOGO_DEFAULT_DEVICE | 默认设备序列号或 ip:port | - | | AUTOGO_PROJECT_PATH | AutoGo 项目根目录（可选，支持自动检测） | - |

🔄 自动检测项目目录

MCP 会自动从当前工作目录向上查找 AutoGo 项目目录（检测 main.go 中是否包含 github.com/Dasongzi1366/AutoGo 或 autogo.cc）。

优先级：

显式传入的 projectPath 参数
环境变量 AUTOGO_PROJECT_PATH
自动检测当前目录及父目录

🔌 MCP 客户端配置

最简配置

{
  "mcpServers": {
    "autogo": {
      "command": "npx",
      "args": ["-y", "@donghao1980/autogo-mcp"]
    }
  }
}

macOS 示例

{
  "mcpServers": {
    "autogo": {
      "command": "npx",
      "args": ["-y", "@donghao1980/autogo-mcp"],
      "env": {
        "AUTOGO_AG_PATH": "/Users/Shared/ag",
        "AUTOGO_ADB_PATH": "/opt/homebrew/bin/adb",
        "AUTOGO_DEFAULT_DEVICE": "emulator-5554"
      }
    }
  }
}

📖 使用示例

应用管理

// 获取当前应用包名
{}

// 启动应用
{
  "packageName": "com.tencent.mm"
}

// 启动指定 Activity
{
  "packageName": "com.tencent.mm/.ui.LauncherUI"
}

// 安装应用
{
  "path": "/sdcard/app.apk"
}

// 强制停止应用
{
  "packageName": "com.tencent.mm"
}

图色操作

// 截图
{
  "remotePath": "/sdcard/screenshot.png",
  "localPath": "C:\\screenshots\\screen.png"
}

// 找色
{
  "color": "#FF0000",
  "region": [100, 200, 300, 400],
  "threshold": 4
}

// 多点找色
{
  "firstColor": "#f64d30",
  "colors": [[5, 5, "#ffffff"], [10, 10, "#000000"]],
  "threshold": 4
}

OCR 文字识别

// 全屏 OCR
{}

// 区域 OCR
{
  "x": 100,
  "y": 200,
  "width": 300,
  "height": 100
}

// 查找文字
{
  "text": "登录",
  "confidence": 0.8
}

YOLO 目标检测

// 全屏检测
{
  "confidence": 0.5,
  "iou": 0.45
}

// 查找特定目标
{
  "className": "person",
  "confidence": 0.6
}

OpenCV 图像处理

// 模板匹配
{
  "templatePath": "/sdcard/template.png",
  "threshold": 0.8
}

Motion 运动检测