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