SSH MCP Server

SSH MCP Server is a local Model Context Protocol (MCP) server that exposes SSH control for Linux and Windows systems, enabling LLMs and other MCP clients to execute shell commands securely via SSH.

Features

MCP-compliant server exposing SSH capabilities
Execute shell commands on remote Linux and Windows systems
Secure authentication via password or SSH key
Read-only mode with built-in security checks
Built with TypeScript and the official MCP SDK

Available Tools

Tool	Description
`get_available_connections`	Lists machines available to connect via SSH
`create_connection`	Opens a new SSH session and tracks it by `connection_id`
`get_connections`	Lists all active SSH sessions
`execute_command`	Runs a shell command (unrestricted)
`secure_execute_command`	Safer command execution; blocks destructive actions
`close_connection`	Closes an active SSH session

Quick Start

1. Clone the repository

$ git clone https://github.com/vilasone455/ssh-mcp-server.git

2. Create machine config

Create a machines.json file with the following structure:

[
   {
    "machine_id": "todo-server-01",
    "label": "Todo server",
    "os": "ubuntu",
    "source": "digitalocean",
    "ssh": {
      "host": "192.168.1.11",
      "port": 22,
      "username": "user",
      "password": "your_password_here"
    }
  },
  {
    "machine_id": "build-agent-01",
    "label": "CI Build Agent (Key Auth)",
    "os": "ubuntu",
    "source": "aws",
    "ssh": {
      "host": "192.168.1.12",
      "port": 22,
      "username": "ubuntu",
      "keyPath": "/home/ubuntu/.ssh/id_rsa"
    }
  }

]

Client Setup (Claude Desktop Example)

To integrate this MCP server into Claude Desktop, add both the server command and the required environment variable:

{
  "mcpServers": {
    "ssh-mcp": {
      "command": "node",
      "args": [
        "/path/to/ssh-mcp-server/dist/index.js"
      ],
      "env": {
        "MACHINES_PATH": "/path/to/your/machines.json"
      }
    }
  }
}

Now you can interact with your server using natural language, e.g., "Run uptime on Todo VM."

Disclaimer

Use at your own risk. This server grants shell-level access via MCP. Review commands carefully and run in a secure environment.

Contributing

Star the repo, open issues, and submit pull requests! Feedback is welcome.

This server cannot be installed

security - not tested

license - not found

quality - not tested

A local Model Context Protocol server that allows LLMs to securely execute shell commands on remote Linux and Windows systems via SSH connections.

Related MCP Servers

Shell MCP Server
odysseus0
-
security
F
license
-
quality
A Model Context Protocol server that allows LLMs to execute shell commands and receive their output in a controlled manner.
Last updated -
Python
MCP SSH Server
shaike1
-
security
F
license
-
quality
A secure SSH server implementation for Model Context Protocol that enables remote command execution and file operations, supporting both password and key-based authentication.
Last updated -
8
TypeScript
Remote Command MCP Server
deepsuthar496
-
security
A
license
-
quality
A Model Context Protocol server that enables remote execution of shell commands across different operating systems, automatically handling platform-specific differences between Windows and Unix-like systems.
Last updated -
JavaScript
MIT License
SSH MCP Server
KinoThe-Kafkaesque
A
security
F
license
A
quality
A Model Context Protocol server implementation that enables secure remote command execution via SSH, with features for managing and using SSH credentials.
Last updated -
5
3
JavaScript

View all related MCP servers

Appeared in Searches

Connecting to Remote Hosts in a GUI via an MCP Server

SSH MCP Server

SSH MCP Server

Features

Available Tools

Quick Start

1. Clone the repository

2. Create machine config

Client Setup (Claude Desktop Example)

Disclaimer

Contributing

Related MCP Servers

Shell MCP Server

MCP SSH Server

Remote Command MCP Server

SSH MCP Server

Appeared in Searches

New MCP Servers

MCP directory API