MCP.so
Sign In

MCP SSH Server for Windsurf

@yoi-hibino

About MCP SSH Server for Windsurf

MCP SSH server for Windsurf integration

Basic information

Category

Developer Tools

Runtime

python

Transports

stdio

Publisher

yoi-hibino

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.

Comments

More Developer Tools MCP servers