# AutoGo Mcp

> MCP server for AutoGo and ADB workflows

- **Type:** MCP server
- **Install:** `agentstack add mcp-shige152-autogo-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [shige152](https://agentstack.voostack.com/s/shige152)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [shige152](https://github.com/shige152)
- **Source:** https://github.com/shige152/AutoGo-mcp

## Install

```sh
agentstack add mcp-shige152-autogo-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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` 启动：

```bash
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` 中，可直接这样配置：

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

### 推荐配置

```json
{
  "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 示例

```json
{
  "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"
      }
    }
  }
}
```

## 调用示例

### 运行项目

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

### 读取日志

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

## 本地开发

```bash
npm install
npm run check
npm run build
npm start
```

更多开发与发布说明见 [`CONTRIBUTING.md`](./CONTRIBUTING.md)。

## License

[MIT](./LICENSE)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [shige152](https://github.com/shige152)
- **Source:** [shige152/AutoGo-mcp](https://github.com/shige152/AutoGo-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-shige152-autogo-mcp
- Seller: https://agentstack.voostack.com/s/shige152
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.