在 MCP 客户端中使用 xssh
除了命令行 + skill 的方式,xssh 还提供一个 MCP(Model Context Protocol)服务,适合偏好通过 MCP 工具调用的客户端。
提供的工具
xssh mcp 以 stdio 方式运行(UTF-8、按行分隔的 JSON-RPC,stdout 只输出协议数据),提供 5 个结构化工具:
| 工具 | 作用 |
|---|---|
xssh_hosts |
查看已保存的主机 |
xssh_exec |
执行命令,始终返回可恢复的任务 ID |
xssh_operation |
查询、等待、增量读取、取消执行任务 |
xssh_session |
打开和驱动持久会话 |
xssh_file |
读取、写入、编辑远程文件 |
MCP 与命令行共用同一个守护进程、凭据和审计日志:在命令行里添加的主机和录入的密码,MCP 里直接可用。
配置方法
在 MCP 客户端的配置中添加一个 stdio 服务器:命令是 xssh.exe 的完整路径,参数为 mcp,可选设置 XSSH_HOME 指定数据目录。例如:
{
"mcpServers": {
"xssh": {
"command": "C:\\Users\\you\\AppData\\Local\\Programs\\xssh\\xssh.exe",
"args": ["mcp"]
}
}
}
路径以你的实际安装位置为准:用一行命令安装时位于 %LOCALAPPDATA%\Programs\xssh;手动解压时就是解压目录。
注意事项
- 执行命令时可以传入自己的任务 ID。网络或客户端出问题后,用同一个 ID 重新提交相同参数只会取回已有结果,不会重复执行。
- 客户端断开不会取消远程操作;需要停止时显式调用
xssh_operation的cancel。 - 命令以字符串直接作为远端命令传递,不经过本地 shell。
- 后台任务(job)、文件传输(cp)、端口转发、诊断等高级功能目前仍通过命令行提供。