{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_kb8hfv2f5c5j","handle":"remote-debug-mcp","url":"https://wellknown.network/agents/remote-debug-mcp","links":{"self":"https://wellknown.network/agents/remote-debug-mcp/record.json","html":"https://wellknown.network/agents/remote-debug-mcp","markdown":"https://wellknown.network/agents/remote-debug-mcp/record.md","api":"https://wellknown.network/api/v1/agents/remote-debug-mcp","status":"https://wellknown.network/api/v1/agents/remote-debug-mcp/status","claim":"https://wellknown.network/agents/remote-debug-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/remote-debug-mcp/claim.json","badge":"https://wellknown.network/agents/remote-debug-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/remote-debug-mcp/history","tools":"https://wellknown.network/api/v1/agents/remote-debug-mcp/tools"},"ard":{"identifier":"urn:air::server:remote-debug-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"remote-debug-mcp","summary":"MCP server for remote debugging via SSH and Telnet with persistent background connections","description":"# Remote Debug MCP\n\n基于 MCP (Model Context Protocol) 的远程调试服务器，支持 **SSH** 和 **Telnet** 后台持久化连接，专为远程串口调试和 Android/Linux 设备管理设计。\n\n## 功能\n\n- **SSH** — 持续后台连接远程服务器/Windows PC，支持命令执行、SCP/SFTP 文件传输、MD5 完整性校验、自动重连\n- **Telnet** — 持续后台连接，支持数据收发、串口数据监听、后台监控保存\n- **com2tcp** — 一键桥接 Windows COM 串口到 TCP Telnet，远程调试串口设备\n- **配置文件** — YAML 文件预设连接参数，`ssh_connect(config_name=\"xxx\")` 一键连接\n\n## 安装\n\n```bash\n# 克隆到 ~/.config 目录（推荐，与配置文件路径一致）\nmkdir -p ~/.config\ngit clone https://github.com/zxyyzwd/remote_debug_mcp.git ~/.config/remote_debug_mcp\ncd ~/.config/remote_debug_mcp\n\n# 虚拟环境安装\npython3 -m venv .venv && source .venv/bin/activate && pip install -e .\n\n# 或直接安装\npip install -e .\n```\n\n依赖：Python ≥ 3.10 · pexpect · mcp\n\n## 配置客户端\n\n### OpenCode\n\n`~/.config/opencode/opencode.jsonc`：\n\n```jsonc\n{\n  \"mcp\": {\n    \"remote-debug\": {\n      \"type\": \"local\",\n      \"command\": [\"python3\", \"-m\", \"remote_debug_mcp\"],\n      \"enabled\": true,\n      \"timeout\": 60000\n    }\n  }\n}\n```\n\n### Claude Code\n\n`~/.claude.json`：\n\n```json\n{\n  \"mcp\": {\n    \"remote-debug\": {\n      \"command\": \"python3\",\n      \"args\": [\"-m\", \"remote_debug_mcp\"],\n      \"enabled\": true,\n      \"timeout\": 60000\n    }\n  }\n}\n```\n\n也可用命令行添加：\n\n```bash\nclaude mcp add remote-debug python3 -- -m remote_debug_mcp\n```\n\n> 使用虚拟环境时，将 `python3` 替换为虚拟机环境中的 Python 路径。\n\n配置后重启客户端即可使用。\n\n## 连接配置\n\n### YAML 配置文件\n\n`config.yaml` 放在工作目录或仓库根目录，首次调用 `ssh_connect(config_name=...)` 时自动加载并缓存。\n\n`config.yaml` 默认搜索路径：\n- `./config.yaml`（当前工作目录）\n- `<source_dir>/config.yaml`（源码目录）\n- `<source_dir>/../config.yaml`（`src/` 父目录）\n- `<repo_root>/config.yaml`（仓库根目录）\n- `<repo_root>/src/remote_debug_mcp/config.yaml`（源码包目录）\n- `~/.config/remote-debug-mcp/config.yaml`（用户全局配置）\n\n```yaml\nconnections:\n  # ── SSH 连接 ──────────────────────\n  - name: \"office-pc\"          # 连接名称，后续引用用\n    type: ssh\n    host: \"192.168.1.16\"       # 远程 IP\n    port: 22                   # SSH 端口\n    username: \"zxyyz\"          # 用户名\n    password: \"kaixin123\"      # 密码（明文，仅本地使用）\n\n  - name: \"office-pc-key\"      # 密钥认证\n    type: ssh…","publisher":null,"homepage":"https://github.com/user/remote-debug-mcp","repository":"https://github.com/user/remote-debug-mcp","version":"0.2.1","license":"MIT License  Copyright (c) 2025  Permission is hereby granted, …","protocols":["mcp"],"tags":["android","debugging","mcp","remote-debug","serial","ssh","telnet"],"pricing":null,"endpoints":[{"url":"pypi:remote-debug-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"code.debugging","name":"Debugging","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["code","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"remote-debug-mcp","registry":"pypi","observedAt":"2026-11-03T23:22:58.124Z","publishedAt":"2026-06-14T15:17:04.494280Z","latestVersion":"0.2.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"remote-debug-mcp","url":"https://pypi.org/project/remote-debug-mcp/","firstSeenAt":"2026-09-10T11:26:43.898Z","fetchedAt":"2026-11-03T23:21:51.393Z","normalizedAt":"2026-11-03T23:21:51.393Z"}]},"firstSeenAt":"2026-09-10T11:26:43.898Z","updatedAt":"2026-11-03T23:22:58.124Z"}