MCP SSH Server for Windsurf
@yoi-hibino
About MCP SSH Server for Windsurf
MCP SSH server for Windsurf integration
Basic information
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.
More Developer Tools MCP servers
test
cloudwegoThe ultimate LLM/AI application development framework in Go.
Hello World MCP Server (Reference Extension)
anthropicsDesktop Extensions: One-click local MCP server installation in desktop apps
FastAPI-MCP
tadata-orgExpose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth!
TalkToFigma
sonnylazuardiTalkToFigma: MCP integration between AI Agent (Cursor, Claude Code, Codex) and Figma, allowing Agentic AI to communicate with Figma for reading designs and modifying them programmatically.
Code Index MCP
johnhuang316A Model Context Protocol (MCP) server that helps large language models index, search, and analyze code repositories with minimal setup
Comments