mcp-ssh-server
This project is an MCP-compatible SSH server designed to integrate seamlessly with the Windsurf IDE, supporting SSH operations with both password and key-based authentication.
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.", 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.
- Install dependencies using pip.
Configuration
Configure your SSH connection settings in the Windsurf MCP configuration file.
MCP Endpoints
The server implements various MCP protocol endpoints for managing SSH operations.
Running the Server
Start the server and access the web interface at http://localhost:5050/.
Integration with Windsurf
Configure Windsurf to use this MCP server and troubleshoot using the provided steps if necessary.