MCP SSH Server logo

MCP SSH Server

by yoi-hibino

A Model Context Protocol (MCP) compatible SSH server designed for seamless integration with Windsurf IDE. It resolves communication issues between Windsurf and SSH servers.

View on GitHub

Last updated: N/A

What is MCP SSH Server?

This is an MCP-compatible SSH server that provides the necessary endpoints for Windsurf IDE to communicate and manage SSH connections. It allows Windsurf to interact with SSH servers using the Model Context Protocol.

How to use MCP SSH Server?

  1. Clone the repository. 2. Install the required dependencies using pip install -r requirements.txt. 3. Configure the SSH connection settings in the Windsurf MCP configuration file. 4. Run the server using python app.py. 5. Configure Windsurf to use this MCP server.

Key features of MCP SSH Server

  • 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

Use cases of MCP SSH Server

  • Seamless integration of SSH functionality within Windsurf IDE

  • Automated SSH connection management for Windsurf

  • Resolving Windsurf settings page errors related to SSH communication

  • Providing a standardized interface for SSH operations within Windsurf

FAQ from MCP SSH Server

What is MCP?

Model Context Protocol (MCP) is a protocol used for communication between applications, in this case, Windsurf IDE and the SSH server.

What do I do if I get a 'request failed' error in Windsurf?

This server implementation provides the necessary MCP protocol endpoints to resolve this issue. Ensure the server is running and properly configured in Windsurf.

What are the server requirements?

The server requires Python 3.7 or higher, Flask, and Paramiko.

How do I configure the server?

Configure your SSH connection settings in the Windsurf MCP configuration file, specifying the server's command, arguments, working directory, protocol, host, port, and environment variables.

What MCP endpoints does the server implement?

The server implements endpoints such as /alive, /list_sessions, /mcp/status, /mcp/connect, /mcp/execute, /mcp/disconnect, /ssh/capabilities, and /ssh/sessions.