About MCP SSH Server for Windsurf
MCP SSH Server for Windsurf provides SSH operations over MCP for Windsurf IDE users who manage remote sessions from the IDE. It supports automatic connections, interactive terminals, and password or key-based authentication.
Key features
- 01MCP support for SSH operations
- 02Automatic connection to predefined SSH servers
- 03Interactive SSH terminal
- 04Password and key-based authentication
Use cases
- 01Connect to predefined SSH hosts from Windsurf
- 02Run remote SSH operations in interactive sessions
MCP support
The MCP server exposes endpoints for SSH connections, command execution, disconnection, and session queries, and is compatible with Windsurf.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEMCP 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.
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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.