CodeBuddy + ssh-mcp-server 远程服务故障定位实战
一、远程服务故障排查挑战
- 远程服务器突然报错,需手动 SSH 连接,输密码/私钥,反复确认命令;
- 排查故障时,手动敲 top、df、journalctl 等命令,逐个分析日志、内存、进程;
- 命令记不全,频繁百度,排查耗时;
- 担心 SSH 凭据暴露,不敢随意授权,多人协作排查效率低;
- 遇到复杂故障,不知从何入手,只能一步步试错。
使用 AI 工具组合可解决上述问题。CodeBuddy 负责 AI 分析、指令生成,ssh-mcp-server 负责安全连接远程服务器、执行命令,两者通过 MCP 协议对接,既解决了手动 SSH 的繁琐,又避免了凭据暴露的安全风险。
二、工具介绍
1. CodeBuddy
CodeBuddy 是一款 AI 代码助手,支持插件、IDE、CLI 三端全覆盖,擅长故障分析、命令生成、日志解读。
核心优势:
- 支持自然语言描述故障,自动生成对应的 SSH 命令;
- 自动解析命令输出结果,定位故障原因(如内存溢出、端口占用、配置错误);
- 支持 MCP 协议,可直接对接 ssh-mcp-server;
- 支持 Windows、Mac、Linux 及 VS Code 插件环境。
2. ssh-mcp-server
ssh-mcp-server 是一款基于 SSH 的 MCP 协议服务器,在 CodeBuddy 和远程服务器之间搭建安全通道。
核心优势:
- SSH 凭据本地管理,不暴露给 AI;
- 遵循 MCP 协议,可与支持该协议的 AI 助手无缝集成;
- 支持命令白名单/黑名单机制,防止危险操作;
- 支持 npx 直接运行,无需全局安装;
- 支持多服务器管理,一键切换。
工作流程:CodeBuddy 发送指令 → ssh-mcp-server 建立安全通道 → 远程服务器执行命令 → 返回结果 → CodeBuddy 分析故障。
三、环境准备
3.1 前置条件
- 本地机安装 VS Code 及 CodeBuddy 插件;
- 本地机安装 Node.js;


