Mcp Ssh Server

🚀 MCP SSH 服务器用于 Windsurf

这是一个与 MCP 协议兼容的 SSH 服务器，专为与 Windsurf IDE 实现无缝集成而设计。借助该服务器，用户能够在 Windsurf 中顺畅地进行 SSH 操作，提升开发效率。

🚀 快速开始

安装和设置

先决条件

python >= 3.7
flask
paramiko

安装

1. 克隆仓库：

git clone https://github.com/yoi-hibino/mcp-ssh-server.git
cd mcp-ssh-server

2. 安装依赖项：

pip install -r requirements.txt

配置

在 Windsurf MCP 配置文件中配置您的 SSH 连接设置：

{
"mcpServers": {
"ssh": {
"command": "python3",
"args": [
"/path/to/app.py"
],
"cwd": "/path/to/mcp-ssh-server",
"protocol": "http",
"host": "localhost",
"port": 5050,
"env": {
"SSH_DEFAULT_HOST": "your_hostname",
"SSH_DEFAULT_PORT": "22",
"SSH_DEFAULT_USERNAME": "your_username",
"SSH_DEFAULT_PASSWORD": "your_password"
}
}
}
}

运行服务器

通过运行以下命令启动服务器：

python app.py

这将启动在端口 5050 上的服务器。您可以在 http://localhost:5050/ 访问其网络界面。

与 Windsurf 集成

通过向您的 Windsurf MCP 设置文件添加适当的配置，使 Windsurf 使用此 MCP 服务器。

如果配置完成后仍出现上述错误，请尝试以下步骤：

1. 重新启动 MCP SSH 服务器
2. 完全重启 Windsurf 应用程序
3. 确认服务器已运行且可通过 http://localhost:5050/ 访问
4. 检查所有 MCP 端点是否正确响应

✨ 主要特性

• 完全支持 MCP 协议进行 SSH 操作
• 自动连接到预定义的 SSH 服务器
• 提供交互式终端界面用于 SSH 会话
• 支持基于密码和密钥的身份验证
• 通过 MCP 集成与 Windsurf IDE 兼容

📚 详细文档

常见问题故障排除

Windsurf 设置页面错误

如果在 Windsurf 设置页面中出现错误消息，显示“错误：请求失败。检查您的配置。”（如下图所示），此服务器实现提供了必要的 MCP 协议端点以解决此问题。

该错误通常出现在 Windsurf 无法与 MCP SSH 服务器正常通信时，通常是由于缺少端点或协议兼容性问题导致的。此存储库中的实现包含了与 Windsurf 正确集成所需的全部必要端点。

MCP 端点

服务器实现了以下 MCP 协议端点：