SSH MCP Server

ssh-mcp

SSH MCP server that provides secure shell access to local machines through a Model Context Protocol interface.

Overview

This server implements an SSH client using Paramiko and exposes SSH functionality through MCP tools, allowing AI assistants to execute commands on local machines securely.

Features

• Session Management: Create, manage, and close SSH sessions with unique session IDs
• Command Execution: Execute shell commands with proper input handling
• Sudo Support: Specialized tools for running privileged commands with password authentication
• Interactive Commands: Support for commands requiring user input (e.g., sudo prompts)
• Thread-Safe: Concurrent session management with proper locking

Tools

• ssh_start_session: Initialize SSH connection to localhost
• ssh_exec_command: Execute shell commands with optional input
• ssh_exec_sudo_command: Run sudo commands with automatic password handling
• ssh_close_session: Clean up SSH sessions

Quick Start

1. Install dependencies:
   pip install -r requirements.txt
2. Start the server:
   ./start.sh

The server runs on http://0.0.0.0:7777 and provides an SSE (Server-Sent Events) endpoint for MCP communication.

Configuration

Default SSH credentials:

• Hostname: localhost
• Username: alex
• Password: your-pass

Note: Update these credentials in server.py for production use.