logo
0
0
WeChat Login
wallbreaker<wallbreaker8@users.noreply.gitcode.com>
Rewrite README for AI readability

myt-mcp

Android 设备 RPA 自动化的 MCP Server。基于 MCP 协议 通过 stdio 传输,可被任意 MCP Client 直接调用。

底层操作由 myt-sdk-golang 驱动,通过 RPA 协议与设备端服务通信。

安装

从 Release 下载(推荐):

Release 下载对应平台二进制:

# Linux x64
curl -L -o myt-mcp https://cnb.cool/openmyt/myt-mcp/-/releases/download/v0.1.0/myt-mcp-linux-x64
# Linux arm64
curl -L -o myt-mcp https://cnb.cool/openmyt/myt-mcp/-/releases/download/v0.1.0/myt-mcp-linux-arm64

chmod +x myt-mcp && mv myt-mcp /usr/local/bin/

从源码构建:

需要 Go 1.23+,设置 GOPROXY=https://goproxy.cn,direct(拉取 cnb.cool 依赖需要 direct)。

git clone https://cnb.cool/openmyt/myt-mcp.git
cd myt-mcp
./scripts/build.sh
# 或
go build -ldflags "-s -w" -o myt-mcp .

构建产出在 build/ 目录:myt-mcp-linux-x64myt-mcp-linux-arm64

配置

myt-mcp 通过 stdio JSON-RPC 通信,不直接运行,由 MCP Client 启动。

Claude Desktop

claude_desktop_config.json 中添加:

{
  "mcpServers": {
    "myt": {
      "command": "/usr/local/bin/myt-mcp"
    }
  }
}

Hermes Agent

~/.hermes/config.yaml 中添加:

mcp_servers:
  myt:
    command: /usr/local/bin/myt-mcp

myt-chat

config.json 中指定路径:

{
  "mcp": {
    "server_path": "/usr/local/bin/myt-mcp"
  }
}

手动测试

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | myt-mcp

工具列表

工具参数说明
rpa_connectip, port?, timeout?连接设备(IP:Port),port 默认 30002
rpa_screenshot截图,返回 base64 JPEG + 尺寸
rpa_dump_nodes获取 UI 节点树(按屏幕上/中/下分区)
rpa_clickx, y点击坐标
rpa_double_clickx, y双击坐标(点赞视频)
rpa_swipex1, y1, x2, y2, duration?滑动,duration 默认 350ms
rpa_typetext, clear?输入文字,clear=true 先清空再输入
rpa_keykey按键:home / back / enter / volume_up / volume_down / power / recents / delete 或 keycode
rpa_find_nodeby, value, click?, timeout?按 text / desc / class / id 查找节点,支持 click,默认点击
rpa_open_apppackage打开应用
rpa_shellcommand执行 ADB shell 命令
rpa_dump_xmlall?获取原始 accessibility XML

使用示例

连接设备 → 打开抖音 → 搜索:

1. rpa_connect    {"ip": "10.10.11.6", "port": 30002}
2. rpa_open_app   {"package": "抖音"}
3. rpa_find_node  {"by": "desc", "value": "搜索", "click": true}
4. rpa_type       {"text": "美食", "clear": true}
5. rpa_key        {"key": "enter"}
6. rpa_dump_nodes {}

技术架构

MCP Client (Claude Desktop / Hermes / ...)
    │  stdio JSON-RPC (MCP 协议)
    ▼
myt-mcp (本服务)
    │  RPA 二进制协议 (TCP)
    ▼
设备端 RPA 服务 (myt-sdk)
    │  Accessibility / Input / Shell
    ▼
Android 设备

依赖

License

MIT