Skip to main content
Glama
Sign In
SSH MCP Server

SSH MCP Server

by format37
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

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.

Related MCP server: MCP SSH Server

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.

Claude-desktop config

If using Linux, your config folder is:

/home/username/.config/Claude/claude_desktop_config.json

To enable this u need to enable it in claude desktop: File / Config / Developer / Edit config

SSH Daemon:

Configure ssh daemon:

nano /etc/systemd/system/ssh-mcp.service

Paste (update ur username):

[Unit]                                                                                                                                                                                                                                                         
Description=SSH MCP Server                                                                                                                                                                                                                                     
After=network.target                                                                                                                                                                                                                                           
                                                                                                                                                                                                                                                               
[Service]                                                                                                                                                                                                                                                      
User=alex                                                                                                                                                                                                                                                      
WorkingDirectory=/home/alex/projects/ssh-mcp
ExecStart=/bin/bash -c 'eval "$(/home/alex/anaconda3/bin/conda shell.bash hook)" && conda activate base && /home/alex/anaconda3/bin/uvicorn server:app --host 0.0.0.0 --port 7777'
Restart=on-failure
RestartSec=5s

[Install]
WantedBy=multi-user.target

Start

sudo systemctl daemon-reload
sudo systemctl enable ssh-mcp.service
sudo systemctl start ssh-mcp.service

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessSyncing

Resources

Related MCP Connectors

Related MCP Servers

  • ssh-mcp-server

    ZachFlint
    A
    license
    A
    quality
    C
    maintenance
    Enables AI assistants to securely execute remote SSH commands, perform file transfers, and monitor system status through a standardized interface. It features robust security controls including command whitelisting, blacklisting, and credential isolation to prevent unauthorized operations.
    10
    16 npm
    MIT

  • SSH MCP Server

    uarlouski
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI assistants to securely execute commands, transfer files, and manage port forwarding on remote servers via SSH.
    191 npm
    38
    Apache 2.0

  • mcp-ssh

    seraved
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to run commands on remote SSH-accessible devices via persistent sessions, supporting both POSIX and CLI shells with safety filters.
    -

Appeared in Searches