Skip to content
Back to search

clash-meta-android-mcp

Local MCP server for Clash Meta for Android via authorized ADB

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/fishofouc--clash-meta-android-mcp/badge.svg)](/listings/fishofouc--clash-meta-android-mcp)

HTML

<a href="/listings/fishofouc--clash-meta-android-mcp"><img src="/api/listings/fishofouc--clash-meta-android-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 64 lines
  1. # Clash Meta for Android MCP
  2. 通过已授权的 Android Debug Bridge(ADB),让本地 MCP 客户端控制手机上已安装的 [Clash Meta for Android(CMFA)](https://github.com/MetaCubeX/ClashMetaForAndroid) 并读取排障信息。服务在电脑上通过 stdio 运行。
  3. Local stdio MCP server for controlling an installed copy of Clash Meta for Android and inspecting its diagnostics over authorized ADB.
  4. ## 适用范围
  5. - **应用** Clash Meta for Android 的 Meta 和 Alpha 变体。默认识别 `com.github.metacubex.clash.meta`、`com.github.metacubex.clash.alpha` 和 `com.github.metacubex.clash`。自定义包名可用 `--package` 指定,应用需保留兼容的 CMFA 启动入口。
  6. - **环境** 电脑需要 Python 3.10+、Android SDK Platform-Tools 和支持 stdio 的 MCP 客户端。手机需要授权 ADB。界面操作需要设备解锁并让 CMFA 获得焦点。
  7. - **实际验证** Windows 真机连接 Android 16 上的 CMFA 2.11.23 Alpha,验证了状态、应用日志和退出记录,以及前台和后台的 VPN 启停。启停验收同时核对了前台服务状态与 VPN 接口。Android 16 模拟器上的 2.11.37 Meta 验证了配置导入与激活、VPN 启停、节点切换、界面操作和内核日志采集。
  8. - **限制** 界面操作取决于当前 CMFA 页面和 Android 窗口行为。进程退出历史依赖 Android 11+ 的系统支持。某些厂商系统弹窗可能需要手动处理。
  9. ## 接入
  10. 克隆本仓库,开启手机 USB 调试,连接电脑并接受手机上的调试授权。运行 `adb devices -l` 确认目标设备显示为 `device`。MCP 客户端负责启动 `server.py`,Python 入口仅使用标准库。
  11. 通用 stdio 客户端配置示例,可把 Python 和脚本路径换成自己电脑上的实际路径。
  12. ```json
  13. {
  14. "mcpServers": {
  15. "clash-meta-android": {
  16. "command": "python",
  17. "args": ["-B", "/path/to/clash-meta-android-mcp/server.py"]
  18. }
  19. }
  20. }
  21. ```
  22. 若使用 Codex CLI,在仓库根目录执行对应命令。注册后开始一个新会话。
  23. ```powershell
  24. codex mcp add clash-meta-android -- python -B (Resolve-Path .\server.py).Path
  25. ```
  26. ```sh
  27. codex mcp add clash-meta-android -- python3 -B "$PWD/server.py"
  28. ```
  29. 多台设备并存时,在启动参数中追加 `--serial <adb 序列号>`。同时安装多个变体时,追加 `--package <应用包名>`。ADB 不在 PATH 时,追加 `--adb <adb 可执行文件路径>`。
  30. ## 能做什么
  31. | 用途 | 工具 |
  32. | --- | --- |
  33. | 查看应用版本和 VPN/代理服务状态 | `get_status` |
  34. | 启动或停止 VPN/代理 | `set_tunnel`,操作使用实际安装包名,首次 VPN 授权从 CMFA 主界面进入 |
  35. | 导入订阅 | `prepare_profile_import` 打开编辑草稿,核对后通过界面保存 |
  36. | 激活配置、选节点、调整 DNS 覆写或应用分流 | `open_app` 打开应用,`get_ui` 或 `get_screenshot` 读取页面,再用 `tap`、`swipe`、`press_key`、`type_text` 操作 |
  37. | 读取应用警告、崩溃和退出原因 | `get_logs`、`get_exit_history` |
  38. | 查看 Clash 内核日志 | 从应用「日志」进入实时或历史日志,再读取界面 |
  39. 常规按钮和 DNS 设置可通过文本形式的无障碍树操作,文字模型也能使用。代理节点卡片等自绘控件可能需要截图和像素坐标。每次操作后重新读取界面,使用最新快照令牌。配置 YAML 中没有界面入口的字段可通过导入更新后的订阅来修改。直接逐字段编辑手机现有 YAML 不在本服务范围内。
  40. `type_text` 支持可打印 ASCII。其他字符可通过设备键盘或已有剪贴板文字输入。VPN 授权、权限确认或文件选择页由 CMFA 打开时,可用 `allow_system_dialog: true` 尝试读取。
  41. 日志和界面文本默认遮盖常见凭据与 URL。截图保留可见内容,订阅链接会作为 MCP 调用参数。请按需向受信任的 MCP 客户端开放服务。
  42. > 用 Clash Meta MCP 查看当前 VPN 状态和最近的警告,再打开「设置 → 覆写 → DNS」读出主 DNS。先保持现有配置。
  43. ## 许可
  44. 本仓库采用 GPL-3.0,详见 [LICENSE](LICENSE)。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.