AutoGo MCP

AutoGo MCP 是一个基于 stdio 的 MCP Server，用来把 AutoGo SDK 与常用 ADB 工作流暴露给支持 MCP 的客户端。

功能概览

• run_project：运行 AutoGo 项目到指定设备，支持调试模式
• read_project_logs：读取 run_project 会话的增量日志
• stop_project：停止设备上的 AutoGo 项目
• sync_files：同步项目中的 so 和 assets
• connect_device：连接远程 ADB 设备
• list_devices：列出当前可见的 ADB 设备
• adb_command：执行自定义 ADB 命令
• get_screen_nodes：抓取当前屏幕节点树并按条件过滤

环境要求

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

安装与使用

推荐直接通过 npx 启动：

npx -y autogo-mcp

环境变量

• AUTOGO_AG_PATH：AutoGo SDK 路径
  • Windows 默认：C:\Users\Public\ag.exe
  • macOS 默认：/Users/Shared/ag
• AUTOGO_ADB_PATH：ADB 可执行文件路径，可选
• AUTOGO_DEFAULT_DEVICE：默认设备序列号或 ip:port，可选

MCP 客户端配置

最简配置

如果 ag.exe 位于默认路径，且 adb 已在系统 PATH 中，可直接这样配置：

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

推荐配置

{
  "mcpServers": {
    "autogo": {
      "command": "npx",
      "args": ["-y", "autogo-mcp"],
      "env": {
        "AUTOGO_AG_PATH": "C:\\Users\\Public\\ag.exe",
        "AUTOGO_ADB_PATH": "C:\\Android\\platform-tools\\adb.exe",
        "AUTOGO_DEFAULT_DEVICE": "192.168.1.100:5555"
      }
    }
  }
}

macOS 示例

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

调用示例

运行项目

{
  "device": "192.168.1.100:5555",
  "projectPath": "C:\\path\\to\\autogo-project",
  "debug": false
}

读取日志

{
  "sessionId": "run-2026-04-25T12-00-00-000Z-1",
  "fromOffset": 0,
  "limit": 200
}

本地开发

npm install
npm run check
npm run build
npm start

更多开发与发布说明见 CONTRIBUTING.md。

License

MIT