remote-debug-mcp

# Remote Debug MCP 基于 MCP (Model Context Protocol) 的远程调试服务器，支持 **SSH** 和 **Telnet** 后台持久化连接，专为远程串口调试和 Android/Linux 设备管理设计。 ## 功能 - **SSH** — 持续后台连接远程服务器/Windows PC，支持命令执行、SCP/SFTP 文件传输、MD5 完整性校验、自动重连 - **Telnet** — 持续后台连接，支持数据收发、串口数据监听、后台监控保存 - **com2tcp** — 一键桥接 Windows COM 串口到 TCP Telnet，远程调试串口设备 - **配置文件** — YAML 文件预设连接参数，`ssh_connect(config_name="xxx")` 一键连接 ## 安装 ```bash # 克隆到 ~/.config 目录（推荐，与配置文件路径一致） mkdir -p ~/.config git clone https://github.com/zxyyzwd/remote_debug_mcp.git ~/.config/remote_debug_mcp cd ~/.config/remote_debug_mcp # 虚拟环境安装 python3 -m venv .venv && source .venv/bin/activate && pip install -e . # 或直接安装 pip install -e . ``` 依赖：Python ≥ 3.10 · pexpect · mcp ## 配置客户端 ### OpenCode `~/.config/opencode/opencode.jsonc`： ```jsonc { "mcp": { "remote-debug": { "type": "local", "command": ["python3", "-m", "remote_debug_mcp"], "enabled": true, "timeout": 60000 } } } ``` ### Claude Code `~/.claude.json`： ```json { "mcp": { "remote-debug": { "command": "python3", "args": ["-m", "remote_debug_mcp"], "enabled": true, "timeout": 60000 } } } ``` 也可用命令行添加： ```bash claude mcp add remote-debug python3 -- -m remote_debug_mcp ``` > 使用虚拟环境时，将 `python3` 替换为虚拟机环境中的 Python 路径。 配置后重启客户端即可使用。 ## 连接配置 ### YAML 配置文件 `config.yaml` 放在工作目录或仓库根目录，首次调用 `ssh_connect(config_name=...)` 时自动加载并缓存。 `config.yaml` 默认搜索路径： - `./config.yaml`（当前工作目录） - `<source_dir>/config.yaml`（源码目录） - `<source_dir>/../config.yaml`（`src/` 父目录） - `<repo_root>/config.yaml`（仓库根目录） - `<repo_root>/src/remote_debug_mcp/config.yaml`（源码包目录） - `~/.config/remote-debug-mcp/config.yaml`（用户全局配置） ```yaml connections: # ── SSH 连接 ────────────────────── - name: "office-pc" # 连接名称，后续引用用 type: ssh host: "192.168.1.16" # 远程 IP port: 22 # SSH 端口 username: "zxyyz" # 用户名 password: "kaixin123" # 密码（明文，仅本地使用） - name: "office-pc-key" # 密钥认证 type: ssh…