MCP.so
Sign In

MCP SSH Server for Windsurf

@yoi-hibino

Repository

About MCP SSH Server for Windsurf

MCP SSH server for Windsurf integration

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

Config

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

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

Tools

No tools detected

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

FAQ from MCP SSH Server for Windsurf

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.

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

Basic information

Category

Developer Tools

Transports

stdio

Author

yoi-hibino

More Developer Tools MCP servers

Routebase

Routebase

Routebase keeps your API's design, docs, contract tests, mocks and monitoring in one living OpenAPI spec so they can't drift apart. Agents work on that same source of truth, under your team's permissions.

Altronis

sypherin

MCP server + CLI for Altronis — Singapore AI consulting. Ask the Lyra consultant, generate a grant-matched AI transformation plan, pull curated SG AI events/news. Read-only, wraps altronis.sg.

AptiBuild AI — Career Intelligence

ParklandBuilds

AptiBuild AI — Career Intelligence MCP Server Structured career decision scaffolding for AI agents. Provides personality-conditioned business idea generation, official BLS OEWS wage data, FRED labor market signals, and

Skycloak

Manage your Skycloak-hosted Keycloak: clusters, realms, apps, SSO and users, from any MCP client.

OrangePro

Aamir Siddiqui

OrangePro local-first CLI + MCP server for behavior mapping, grounded test generation, and dynamic proof.

12