MCP SSH Server for Windsurf: Secure Integration, Rock-Solid DevOps

Boost Windsurf ops with MCP's enterprise-grade SSH server – seamless, secure integrations that deliver rock-solid performance for mission-critical dev teams.

Visit Repository

✨ Developer Tools

4.5(126 reviews)

189 saves

88 comments

Users create an average of 16 projects per month with this tool

About MCP SSH Server for Windsurf

What is MCP SSH Server for Windsurf: Secure Integration, Rock-Solid DevOps?

MCP SSH Server for Windsurf is a dedicated SSH server implementation compliant with the Model Context Protocol (MCP), designed to bridge secure SSH operations with the Windsurf IDE. Its core purpose is to enable seamless integration between the IDE and remote systems while ensuring robust DevOps workflows. By providing MCP-compatible endpoints and protocol adherence, it resolves communication gaps and ensures reliable server interactions.

How to Use MCP SSH Server for Windsurf: Secure Integration, Rock-Solid DevOps?

Install Dependencies: Ensure Python 3.7+, Flask, and Paramiko are installed. Use pip install -r requirements.txt after cloning the repository.
Configure Settings: Edit the Windsurf MCP configuration file to specify server details like host, port, and authentication credentials.
Launch the Server: Execute python app.py to start the service on port 5050. Validate accessibility via http://localhost:5050/.
Integrate with Windsurf: Ensure the IDE references the server's endpoints correctly. Restart Windsurf and the server if issues persist.

MCP SSH Server for Windsurf Features

Key Features of MCP SSH Server for Windsurf: Secure Integration, Rock-Solid DevOps?

Protocol Compliance: Full MCP support for actions like session management, command execution, and status checks.
Authentication Flexibility: Supports both password and key-based SSH authentication methods.
Automation Ready: Predefined endpoints for programmatic control (e.g., /mcp/execute, /list_sessions).
Interactive Terminal: Provides a live terminal interface for direct SSH session access.
Stability First: Built with rock-solid error handling and health checks via the /alive endpoint.

Use Cases of MCP SSH Server for Windsurf: Secure Integration, Rock-Solid DevOps?

Typical scenarios include:

Remote Development: Securely connect to production-like environments directly from Windsurf for testing.
CI/CD Pipelines: Automate deployment and configuration tasks using MCP endpoints for consistent DevOps workflows.
Multi-User Collaboration: Manage shared SSH sessions and permissions through the server's centralized interface.
Real-Time Monitoring: Track active sessions and server health without manual intervention via exposed endpoints.

MCP SSH Server for Windsurf FAQ

FAQ from MCP SSH Server for Windsurf: Secure Integration, Rock-Solid DevOps?

Q: The "request failed" error appears in Windsurf settings.

A: This indicates a missing or misconfigured endpoint. Verify the server is running and the MCP endpoints (e.g., /mcp/status) respond correctly. Check the configuration file for typos in host/port fields.

Q: Authentication fails despite correct credentials.

A: Ensure SSH keys are properly formatted if using key-based auth. For passwords, confirm they're set in the env block of the configuration. Restart the server after updates.

Q: How do I test server connectivity?

A: Access http://localhost:5050/alive in a browser. A "Server alive" response confirms basic functionality.

Q: Can I customize the server port?

A: Yes. Modify the port value in the configuration file and restart the server. Update Windsurf's settings accordingly.

Content

MCP SSH Server for Windsurf

A Model Context Protocol (MCP) compatible SSH server designed for seamless integration with Windsurf IDE.

Features

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

Troubleshooting Common Issues

Windsurf Settings Page Error

If you encounter an error message in the Windsurf Settings page showing "Error: request failed. Check your configuration." as shown in the image below, this server implementation provides the necessary MCP protocol endpoints to resolve this issue.

Windsurf Settings Error Message

This error typically appears when Windsurf cannot properly communicate with the MCP SSH server due to missing endpoints or protocol compatibility issues. The implementation in this repository includes all the necessary endpoints required for proper integration with Windsurf.

Setup and Installation

Requirements

python >= 3.7
flask
paramiko

Installation

Clone the repository:

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

Install dependencies:

pip install -r requirements.txt

Configuration

Configure your SSH connection settings in the Windsurf MCP configuration file:

{
  "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 Endpoints

The server implements the following MCP protocol endpoints:

/alive - Server health check
/list_sessions - List active SSH connections
/mcp/status - Check MCP server status
/mcp/connect - Connect to SSH server
/mcp/execute - Execute commands on SSH server
/mcp/disconnect - Disconnect from SSH server
/ssh/capabilities - List SSH server capabilities
/ssh/sessions - List active SSH sessions

Running the Server

Start the server by running:

python app.py

This will start the server on port 5050. You can access the web interface at http://localhost:5050/

Integration with Windsurf

Configure Windsurf to use this MCP server by adding the appropriate configuration to your Windsurf MCP settings file.

After configuring, if you still encounter the error shown above, try these steps:

Restart the MCP SSH server
Completely restart the Windsurf application
Verify the server is running and accessible at http://localhost:5050/
Check that all MCP endpoints are responding correctly