MCP SSH Server for Windsurf

Overview

基本能力

产品定位

MCP SSH Server for Windsurf 是一个专为 Windsurf IDE 设计的 SSH 服务器，通过 MCP 协议提供无缝的 SSH 操作集成。

核心功能

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

适用场景

开发者在 Windsurf IDE 中需要远程 SSH 连接
需要自动化 SSH 操作的项目
需要与 Windsurf IDE 集成的 SSH 服务器

工具列表

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

常见问题解答

Windsurf 设置页面错误：如果 Windsurf 设置页面显示 "Error: request failed. Check your configuration."，通常是由于 Windsurf 无法与 MCP SSH 服务器正确通信。解决方法包括重启 MCP SSH 服务器、完全重启 Windsurf 应用程序、验证服务器是否在运行以及检查所有 MCP 端点是否正确响应。

使用教程

使用依赖

Python >= 3.7
Flask
Paramiko

安装依赖的命令：

pip install flask paramiko

安装教程

克隆仓库：

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

安装依赖：

pip install -r requirements.txt

配置 SSH 连接设置：在 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/ 访问 Web 界面。

如果遇到问题，可以尝试以下步骤： 1. 重启 MCP SSH 服务器 2. 完全重启 Windsurf 应用程序 3. 验证服务器是否在运行并可访问 http://localhost:5050/ 4. 检查所有 MCP 端点是否正确响应

许可证

None