MCP SSH Server - Remote Server Control for Claude

🚀 Connect Claude AI to your remote server via SSH. Read files, write files, execute commands, and manage your server directly from Claude Desktop!

Features

✅ Full SSH Access - Connect to any SSH server
✅ SSH Key Generator - Generate keys directly in installer
✅ Multiple Servers - Add, remove, and manage unlimited servers
✅ Easy Server Management - Add servers by just talking to Claude
✅ No Code Editing - Manage everything through conversation
✅ File Operations - Read, write, and manage files
✅ Command Execution - Run any command on your server
✅ Directory Listing - Browse your server's filesystem
✅ Auto-Updates - Automatically checks for updates every 12 hours
✅ Secure - Supports SSH keys and password authentication
✅ Easy Installation - Simple GUI installer for Windows

Quick Start

1. Download Installer

Download the latest MCP-SSH-Installer.exe from Releases

2. Run Installer

1. Enter first server details:

   • Server name (e.g., "production")

   • Server IP, port, and username

   • Choose authentication:

     • SSH Key (Recommended):

       • Click "🔑 Generate New" to create a new SSH key

       • Or click "Browse" to select an existing key

       • Copy the public key shown and add it to your server (instructions provided)

     • Password: Enter your SSH password

2. Click "➕ Add Server"

3. Repeat to add more servers (optional)

4. Click "Install"

3. Restart Claude Desktop

Close and reopen Claude Desktop. You're done! 🎉

Usage Examples

Once installed, you can ask Claude:

Managing Servers

• "List all my servers" - Show all configured servers

• "Add a new server called staging with IP 192.168.1.50, username admin, password mypass123"

• "Add server named aws-prod, IP 54.123.45.67, port 2222, user root, using SSH key C:\Users\Me\.ssh\aws_key"

• "Remove server staging" - Delete a server

• "Edit server production, change IP to 10.0.0.5" - Update server details

• "Switch to development server" - Change active server

• "What server am I connected to?" - Show current server

File Operations

• "List files in /var/www"

• "Read the file /etc/nginx/nginx.conf"

• "Create a file /home/user/test.txt with content 'Hello World'"

Commands

• "Execute command: df -h"

• "Show me the contents of /var/log"

Manual Installation

If you prefer manual installation:

Create config.json with your settings and add to Claude Desktop config.

Multiple Servers

You can add servers directly through Claude without editing any files!

Example conversation:

Or manually create config.json:

Then ask Claude:

• "List all servers"

• "Switch to development"

• "What server am I on?"

• "Add server staging with IP 10.0.0.5, user ubuntu, password test123"

• "Remove server old-server"

• "Edit server production, change password to newpass456"

Auto-Update

The server automatically checks for updates every 12 hours. When an update is available, it will download and install automatically. Just restart Claude Desktop to apply updates.

Security

⚠️ Important Security Notes:

• SSH Keys Recommended - Use SSH keys instead of passwords

• Limited User - Create a dedicated user instead of using root

• Firewall - Ensure your SSH port is properly secured

• Config Protection - Your config.json contains credentials - keep it safe!

Setting up SSH Keys

Option 1: Generate in Installer (Easiest)

1. In the installer, select "SSH Key"

2. Click "🔑 Generate New"

3. Copy the public key shown

4. On your server, run:

Option 2: Manual Generation

Troubleshooting

Connection Issues

• Verify server IP and port

• Check SSH credentials

• Test connection: ssh username@server-ip

• Check firewall settings

Claude Desktop Not Seeing Server

• Verify config path in claude_desktop_config.json

• Restart Claude Desktop completely

• Check for errors in Claude Desktop logs

Updates Not Working

• Ensure Git is installed

• Check GitHub repository URL

• Verify internet connection

• Check file permissions

Development

Want to contribute?

Make your changes and submit a Pull Request!

Server Management Commands

All server management can be done through natural conversation with Claude:

Adding Servers

With SSH Key:

With Password:

Minimal (uses defaults):

Editing Servers

Change IP:

Change Password:

Change Multiple Fields:

Removing Servers

Switching Servers

Listing Servers