Windsurf 的 MCP SSH 服务器

一个与模型上下文协议 (MCP) 兼容的 SSH 服务器，旨在与 Windsurf IDE 无缝集成。

功能

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

解决常见问题

Windsurf 设置页面错误

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

此错误通常在 Windsurf 无法与 MCP SSH 服务器正确通信时出现，原因是缺少端点或协议兼容性问题。 此存储库中的实现包括与 Windsurf 正确集成所需的所有必要端点。

设置和安装

要求

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"
      }
    }
  }
}

MCP 端点

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

• /alive - 服务器健康检查
• /list_sessions - 列出活动 SSH 连接
• /mcp/status - 检查 MCP 服务器状态
• /mcp/connect - 连接到 SSH 服务器
• /mcp/execute - 在 SSH 服务器上执行命令
• /mcp/disconnect - 断开与 SSH 服务器的连接
• /ssh/capabilities - 列出 SSH 服务器功能
• /ssh/sessions - 列出活动 SSH 会话

运行服务器

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

python app.py

这将在端口 5050 上启动服务器。 您可以通过 http://localhost:5050/ 访问 Web 界面

与 Windsurf 集成

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

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

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