MCP SSH Server for Windsurf

@yoi-hibino

Repository

Basic information

About MCP SSH Server for Windsurf

MCP SSH server for Windsurf integration

#mcp-ssh-server#windsurf#ssh-integration

MCP SSH Server for Windsurf config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-ssh-server": {
      "command": "python",
      "args": [
        "app.py"
      ]
    }
  }
}

MCP SSH Server for Windsurf tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP SSH Server for Windsurf?

A Model Context Protocol (MCP) compatible SSH server designed for seamless integration with Windsurf IDE. It enables SSH operations—such as connecting, executing commands, and managing sessions—directly through Windsurf’s MCP interface.

How to use MCP SSH Server for Windsurf?

Clone the repository, install dependencies (pip install -r requirements.txt), and configure the Windsurf MCP settings file with your SSH credentials as environment variables (SSH_DEFAULT_HOST, SSH_DEFAULT_PORT, SSH_DEFAULT_USERNAME, SSH_DEFAULT_PASSWORD). Run python app.py to start the server on port 5050. Then add the MCP server configuration (command: python3, args: path to app.py, protocol: http, host: localhost, port: 5050) to your Windsurf MCP config.

Key features of MCP SSH Server for Windsurf

Full MCP protocol support for SSH operations
Auto-connect to predefined SSH servers
Interactive terminal interface for SSH sessions
Support for both password and key-based authentication
Compatible with Windsurf IDE through MCP integration
Implements necessary MCP endpoints for proper Windsurf integration

Use cases of MCP SSH Server for Windsurf

Managing remote servers directly from Windsurf IDE
Executing commands on SSH servers via MCP commands
Automating SSH tasks within Windsurf workflows
Troubleshooting Windsurf MCP connection errors

Frequently asked questions

What is the purpose of this server?

It provides MCP protocol endpoints that allow Windsurf IDE to communicate with SSH servers for remote management and command execution.

What are the runtime requirements?

Python 3.7 or higher, plus the Flask and Paramiko libraries (installed via `pip install -r requirements.txt`).

How do I configure SSH credentials?

Set the environment variables `SSH_DEFAULT_HOST`, `SSH_DEFAULT_PORT`, `SSH_DEFAULT_USERNAME`, and optionally `SSH_DEFAULT_PASSWORD` in the Windsurf MCP configuration file.

What MCP endpoints does the server expose?

The server implements `/alive`, `/list_sessions`, `/mcp/status`, `/mcp/connect`, `/mcp/execute`, `/mcp/disconnect`, `/ssh/capabilities`, and `/ssh/sessions`.

How can I resolve the “Error: request failed” message in Windsurf Settings?

Ensure the server is running at `http://localhost:5050/`, restart both the MCP SSH server and the Windsurf application, and verify that all MCP endpoints respond correctly.

Comments

More Developer Tools MCP servers

Vibgrate MCP

Vibgrate

Query your team's drift, vulnerability, and migration data from any AI assistant. Vibgrate MCP connects Cursor, Claude, ChatGPT, Windsurf, or VS Code to Vibgrate Cloud: 51 tools for DriftScores, CVEs and EOL runtimes, up

Casefile

azimov777

One case file per task — shared by every session, agent and person that touches it. Self-hosted MCP server and live board. MIT.

BetterBugs

The BetterBugs MCP (Model Context Protocol) enables you to load BetterBugs bug reports (via report links) directly to your preferred AI Agents and developer environments with MCP Client capabilities (such as Cursor, VS C

Meticulous

SayLive

SayLIive

Publish the website your AI assistant just built, straight from the conversation. Static sites, your own domain, one payment, no subscription.