内容
[](https://github.com/dpkay-io/toggldev-remote) [](https://github.com/dpkay-io/toggldev-remote) [](https://github.com/dpkay-io/toggldev-remote) [](https://github.com/dpkay-io/toggldev-remote) [](https://github.com/dpkay-io/toggldev-remote) [](https://github.com/dpkay-io/toggldev-remote) [](https://github.com/dpkay-io/toggldev-remote) [](https://www.npmjs.com/package/toggldev-remote) [](https://www.npmjs.com/package/toggldev-remote) [](https://nodejs.org)
# toggldev-remote
**从终端控制您的安卓开发者选项 — 或让您的AI代理为您操作**
CLI 和 MCP 服务器，用于在本地网络上发现、配对和控制安卓设备上的开发者选项。不需要 USB 数据线，不需要在菜单中手动点击。
📱 **配套 TogglDev 应用：** 可在 [Google Play](https://play.google.com/store/apps/details?id=com.dpkay.apps.developer_options_toggler) 和 [Github](https://github.com/dpkay-io/toggldev) 上找到
## 安装
```bash
npm install -g toggldev-remote
```
此命令安装两个命令：
| 命令 | 用途 |
|---------|---------|
| **`toggldev`** | 直接终端使用的 CLI |
| **`toggldev-mcp`** | 用于 AI 客户端的 MCP 服务器 |
---
## 问题
您正在进行编码， 需要在手机上启用无线调试或更改动画缩放比例用于测试。于是，您拿起手机，解锁，导航到开发者选项，切换设置，然后回到终端。
使用 AI 代理时，情况更糟 — 代理可以构建您的应用，但无法触及您的手机并翻转开关。
## 解决方案
**通过终端：**
```bash
toggldev toggle --key adb_wifi_enabled --enabled true
```
**通过 AI 代理（MCP）：**
> *"启用无线调试"*
一个命令或一个提示给您的 AI — 无需人工介入。
---
## 功能
- **自动发现** — 通过 mDNS 在本地网络上查找运行 TogglDev 的设备。无需记住 IP 地址。
- **安全配对** — 使用 TogglDev 应用的 6 位配对码连接。凭证将保存以供未来会话使用。
- **完全控制** — 切换开发者设置，设置动画缩放比例，获取设备状态，检索无线调试连接信息。
- **MCP 服务器** — 适用于 Claude、Cursor、Gemini 和任何兼容 MCP 的 AI 代理的工具提供程序。
- **远程访问** — 通过 Tailscale 配对，在任何网络上控制您的设备。
---
## 前置条件
- **Node.js** （v18+）
- **[TogglDev 安卓应用](https://github.com/dpkay-io/toggldev)** v2.0+ — 可在 [Google Play](https://play.google.com/store/apps/details?id=com.dpkay.apps.developer_options_toggler) 或 [GitHub Releases](https://github.com/dpkay-io/toggldev/releases/latest) 上找到
- 您的电脑和安卓设备在 **同一本地网络** （或通过 Tailscale 连接）
---
## 快速开始
```bash
# 1. 在网络上找到您的手机
toggldev discover
# 2. 打开 TogglDev 应用，记下 6 位代码，然后配对
toggldev pair --host 192.168.1.100 --port 8734 --code 123456
# 3. 启用无线调试
toggldev toggle --key adb_wifi_enabled --enabled true
# 4. 获取 ADB 连接信息
toggldev wireless-debug-info
# 5. 连接 ADB
adb connect <ip>:<port>
```
---
## CLI 参考
### 发现设备
```bash
toggldev discover
toggldev discover --timeout 10
```
### 与设备配对
```bash
toggldev pair --host <ip> --port <port> --code <code>
```
将身份验证保存到 `~/.toggldev/config.json`。
### 获取设备状态
```bash
toggldev status
```
### 切换设置
```bash
toggldev toggle --key adb_wifi_enabled --enabled true
```
### 设置值
```bash
toggldev set --key window_animation_scale --value 0.5
```
### 获取无线调试信息
```bash
toggldev wireless-debug-info
```
---
## AI 代理设置（MCP）
将 toggldev-remote 用作任何 MCP 兼容 AI 助手的工具提供程序。
### Claude Code
```bash
claude mcp add toggldev toggldev-mcp
```
### Claude 桌面版
将以下内容添加到您的 `claude_desktop_config.json` 中：
```json
{
"mcpServers": {
"toggldev": {
"command": "toggldev-mcp",
"args": []
}
}
}
```
### Cursor IDE
1. **设置** > **功能** > **MCP**
2. **+ 添加新的 MCP 服务器**
3. 类型：`command`，命令：`toggldev-mcp`
### Gemini CLI / 其他 MCP 客户端
将您的 MCP 配置指向：
```bash
toggldev-mcp
```
---
## MCP 工具
| 工具 | 描述 |
|------|-------------|
| `discover_devices` | 在本地网络上查找 TogglDev 实例 |
| `pair_device` | 使用主机、端口和配对码与设备配对 |
| `get_status` | 获取当前开发者选项状态 |
| `toggle_setting` | 切换布尔设置（例如 `adb_wifi_enabled`） |
| `set_setting` | 为设置（例如 `window_animation_scale` 至 `0.5`）设置值 |
| `get_wireless_debug_info` | 获取无线 ADB 连接的 IP 和端口 |
---
## 远程访问
默认情况下，发现和控制功能在本地网络上工作。要从任何地方控制您的设备：
1. 在您的电脑和安卓手机上安装 [Tailscale](https://tailscale.com/download)
2. 使用相同的帐户在两者上登录
3. 记下您的手机的 Tailscale IP（通常为 `100.x.x.x`）
4. 使用该 IP 配对：
```bash
toggldev pair --host 100.x.x.x --port 8734 --code <code>
```
配对后，所有命令都可以在任何网络上运行。Tailscale IP 在网络更改时保持稳定。
> **注意：** `toggldev discover` 使用 mDNS，该功能在 Tailscale 上不起作用。请直接使用 Tailscale IP 进行配对。
