ssh-mcp-py

# SSH MCP: Model Context Protocol tool for Virtual Machine Management over SSH SSH MCP is a Model Context Protocol tool written in Python for managing and interacting with multiple virtual machines (VMs) over SSH. It simplifies executing commands on remote servers by using the standard SSH config file format and leverages the robust `paramiko` library to handle SSH connections and command execution securely and efficiently. ----- ## Usage Guide 📖 SSH MCP can be used in two ways: as an MCP server or as a direct command-line tool. ### MCP Server Usage SSH MCP can also run as an MCP server, providing tools that can be used by AI assistants and other MCP clients: ```bash uv run ssh-mcp-py ``` **Available MCP Tools:** 1. **execute_ssh_command**: Execute a command on a remote host - Parameters: `hostname` (string), `command` (string) 2. **list_ssh_hosts**: List all configured SSH hosts - Parameters: None 3. **get_host_info**: Get detailed information about a specific host - Parameters: `hostname` (string) 4. **test_ssh_connection**: Test SSH connection to a host - Parameters: `hostname` (string) ### Integration with Claude Desktop To use SSH MCP with Claude Desktop, add the following configuration to your `claude_desktop_config.json`: ```json { "mcpServers": { "ssh": { "command": "uvx", "args": [ "ssh-mcp-py" ], "env": { "MCP_TRANSPORT": "stdio", "SSH_CONFIG_PATH": "/Users/your_username/.ssh/config" } } } } ``` **Configuration File Location:** - **macOS**: `/Users/your_username/Library/Application Support/Claude/claude_desktop_config.json` Replace `your_username` with your actual username ### Direct Command-Line Usage You can execute commands directly using the command line interface: **Basic Command Execution**: ```bash uv run cli.py <host> "<command_to_execute>" ``` **Examples**: To list the files in the home directory of `web-server-01`: ```bash uv run cli.py web-se…