Ssh MCP

Operating system automation Developer tools Remote .TypeScript

rating : 2 points

downloads : 9.9K

update time : 2025-04-28

What is SSH MCP Server?

SSH MCP Server is a local service that serves as a secure bridge between AI assistants and remote servers. Through the standardized Model Context Protocol (MCP), it allows AI tools such as Claude to securely perform server management operations via the SSH protocol.

How to use SSH MCP Server?

After completing the installation and configuration, simply enable the service in a supported AI client (such as Claude Desktop), and you can use natural language to command the remote server to execute commands.

Applicable scenarios

Suitable for scenarios such as system administrators who need to manage multiple servers through AI assistants, developers managing test environments, and controlling educational experimental environments.

Main features

Remote command execution

Execute any Shell/PowerShell command on the target server through the exec tool

Cross-platform support

Compatible with Linux and Windows server systems

Multiple authentication

Supports two authentication methods: password and SSH key

Advantages

No need to memorize complex commands, operate the server with natural language

The execution process is encrypted and transmitted through the standard SSH protocol

Seamlessly integrated with mainstream AI clients

Limitations

Need to pre-configure SSH connection information

May require step-by-step guidance when performing complex tasks

Windows servers need to pre-configure the SSH service

How to use

Install the service

Install via npm or clone the Git repository

Configure the client

Add SSH connection parameters to the AI client configuration file

Start using

Enter server management instructions in the AI chat window

🚀 SSH MCP Server

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

🚀 Quick Start

Install the SSH MCP Server.
Configure the SSH MCP Server.
Set up your MCP client (e.g., Claude Desktop, Cursor, etc.).
Use natural language to execute shell commands on a remote Linux or Windows server via SSH.

✨ Features

A server compliant with the MCP protocol, exposing SSH functionality.
Execute shell commands on remote servers.
Secure authentication via password or SSH key.
Built with TypeScript and the official MCP SDK.

Tools

exec: Execute shell commands on remote servers.

📦 Installation

Clone the repository:

git clone https://github.com/tufantunc/ssh-mcp.git
cd ssh-mcp

Install dependencies:
```
npm install
```

📚 Documentation

Client Setup

You can configure Claude Desktop to use this MCP server.

host: The hostname or IP address of the Linux or Windows server.
port: The SSH port (default: 22).
user: The SSH username.
password: The SSH password (or use key for key authentication) (optional).
key: The path to the private SSH key (optional).

{
    "mcpServers": {
        "ssh-mcp": {
            "command": "npx",
            "args": [
                "ssh-mcp",
                "-y",
                "--",
                "--host=1.2.3.4",
                "--port=22",
                "--user=root",
                "--password=pass",
                "--key=path/to/key"
            ]
        }
    }
}

Testing

You can use the MCP Inspector for visual debugging of this MCP server.

npm run inspect

📄 License

The SSH MCP Server is provided under the MIT License. Use it at your own risk. This project is not affiliated with or endorsed by any SSH or MCP provider.