Network Operator MCP

network-operator-mcp 使得 Agent 可以访问网络设备的管理界面（例如 STelenet 等）， 同时把凭据留在 MCP 服务端。设备通过 type 选择交互模型，目前实现两种后端：

• ssh-terminal：持续存在的 SSH PTY，适合华为 VRP 等交互式网络 CLI。

• ssh-exec：标准 SSH exec channel，一次调用执行一个命令，返回 stdout、stderr、 exit status 和 exit signal，适合 OpenWrt、MikroTik 等设备。

MCP 仅提供在 Agent 和设备之间传递消息的能力，不识别提示符，不解释设备输出，也不判断终端命令是否成功。

该 MCP 支持 stdio、Streamable HTTP 和 SSE 三种 transport。

已测试设备：

配置

配置分为后端参数、账户和设备三部分：

backends:
  ssh-terminal:
    connect_timeout_seconds: 15
    default_quiet_timeout_ms: 1000
    default_deadline_ms: 15000
    default_response_limit_bytes: 200000
    max_sessions: 10
    session_idle_ttl_seconds: 600
    max_session_lifetime_seconds: 3600
  ssh-exec:
    connect_timeout_seconds: 15
    default_command_timeout_seconds: 60

accounts:
  password-operator:
    username: netadmin
    password: plaintext-password

  key-operator:
    username: root
    private_key: |
      -----BEGIN OPENSSH PRIVATE KEY-----
      ...
      -----END OPENSSH PRIVATE KEY-----

devices:
  example-huawei:
    type: ssh-terminal
    host: 192.0.2.10
    port: 22
    account: password-operator

  example-openwrt:
    type: ssh-exec
    host: 192.0.2.20
    port: 22
    account: key-operator

账户可以被多个设备引用。账户支持 password、内联 private_key 和可选的 private_key_passphrase。

AsyncSSH 不校验服务器 Host Key。

MCP 工具

SSH exec

ssh_execute 接收 device、command、可选的 stdin 和 timeout_seconds，返回：

{
  "device": "example-openwrt",
  "server_version": "SSH-2.0-dropbear",
  "stdout": "Linux OpenWrt ...\n",
  "stderr": "",
  "exit_status": 0,
  "exit_signal": null,
  "elapsed_ms": 80
}

每次调用建立一个 SSH connection、发出一个 exec request、等待 EOF 和退出状态， 然后关闭连接。这里的完成边界来自 SSH 协议，不使用 quiet timeout 或提示符判断。

SSH terminal

每个终端会话都有后台 Reader，把设备输出持续追加到临时 transcript。MCP 调用超时 只结束本次等待，不停止 SSH 数据流。

终止读取的原因：

• quiet：收到输出后，连续一段时间没有新字节；不表示命令完成。

• deadline：本次等待到期，设备可能仍在运行或输出。

• response_limit：达到响应大小限制，用返回的 cursor 继续读取。

• eof：SSH terminal channel 已结束。

deadline 和 response_limit 会把会话标记为 unsettled。调用方应继续读取、发送 CTRL_C，或者明确使用 force_write=true。

exchange 的 input_type：

• line：编码文本并追加 CR。

• text：只发送文本本身。

• key：支持 ENTER、SPACE、CTRL_C、CTRL_Z 和 Q。

每次写入使用新的 request_id；使用相同 ID 重试会返回原结果，不会重复写入。 expected_outbound_seq 用来确认调用方掌握最新写入顺序。

调用方必须把 initial_output.next_cursor 传给第一次 exchange，然后持续传递每次 返回的 next_cursor。服务端在写入前记录 write_cursor，并从调用方 cursor 返回 输出，因此 quiet 后迟到的字节不会被下一次写入跳过。

opened = open_session(device)
cursor = opened.initial_output.next_cursor
seq = opened.session.outbound_seq

r1 = exchange(session_id, request_id="1", data="screen-length 0 temporary",
              cursor=cursor, expected_outbound_seq=seq)
cursor = r1.next_cursor
seq = r1.outbound_seq

一个终端会话只属于创建它的 MCP client session。同一服务进程中，一台 ssh-terminal 设备最多只有一个会话。其他客户端不能查看或接管该会话，尝试连接 时会得到明确的“被另一 MCP 客户端占用，请等待”错误。占用一直保留到 SSH 关闭 完成。