SSH Remote MCP Server

SSH remote access for Claude Code through Model Context Protocol (MCP).

Quick Start

1. Install:

   pip install -r requirements.txt

2. Configure Claude Desktop:

   For Claude Desktop App: Add to %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (Mac):

   { "mcpServers": { "ssh-remote": { "command": "python", "args": ["/absolute/path/to/ssh_mcp_server.py"] } } }

   For Claude Code: Add to your Claude Code MCP config:

   { "ssh-remote": { "command": "python", "args": ["/path/to/ssh_mcp_server.py"] } }

3. Restart Claude Desktop and test:

   Just chat naturally with Claude:

   • "Connect to my server at 192.168.1.100 with username ubuntu and password mypass"

   • "List files in the home directory on my server"

   • "Upload file.txt to /home/ubuntu/ on the server"

   • "Run 'htop' command on my remote server"

Features

• Connect to remote servers via SSH

• Execute commands remotely

• Upload/download files via SFTP

• Manage multiple connections

• Health monitoring

Configuration Example

Usage Examples

Connect with password:

Connect with SSH key:

Execute commands:

File transfers:

Requirements

• Python 3.7+

• paramiko

• mcp

Security

• Automatic host key acceptance

• Supports password and key authentication

• Connection timeouts enforced