ssh

SSH MCP Server provides an enterprise-grade interactive SSH experience within MCP clients. It supports a complete interactive terminal, enabling running full-screen editors like vim, system monitors like top/htop, debuggers such as gdb, and session-based workflows with session management and output buffering. This server emphasizes instant shell startup, asynchronous execution, robust output handling, and a rich command audit trail, making remote operations more fluid and auditable. To use it, configure your MCP client to point at the ssh-mcp server binary, then initiate a session by issuing a natural-language command such as starting a shell on a remote host, executing a command like ls -la, or launching an interactive program like vim or gdb. The client will manage the connection, deliver input, and display filtered, clean output while preserving interactive capabilities.

Prerequisites:

• Go development environment (Go 1.18+ recommended)
• Git

Installation steps:

1. Clone the repository: git clone https://github.com/Cigarliu/ssh-mcp-server.git
2. Build the MCP server binary: cd ssh-mcp-server go build -o bin/sshmcp ./cmd/server
3. Verify the binary exists: ls -l bin/sshmcp
4. Run the server (example): ./bin/sshmcp
5. Integrate with MCP clients by providing the server path in their configuration, for example: { "mcpServers": { "ssh-mcp": { "command": "/path/to/sshmcp", "args": [], "env": { "SSH_MCP_LOG_LEVEL": "info" } } } }

Tips and notes:

• Ensure the ssh-mcp-server binary has execute permissions and is reachable by your MCP client.
• Use an absolute path in client configurations to avoid path resolution issues.
• The server supports an environment variable SSH_MCP_LOG_LEVEL to control verbosity; common values are debug, info, warn, error.
• For complex remote environments, ensure the target systems allow interactive SSH sessions and that password/privilege elevation methods are compatible with auto-sudo workflows if used.
• If you encounter ANSI or terminal-size issues, leverage the MCP client's terminal resizing and ANSI filtering options; the server is designed to handle dynamic terminal dimensions.
• Check connection keepalive settings if you experience timeouts; the SSH backend relies on stable network connectivity for interactive sessions.