mcp-ssh-toolkit-py
If you are the rightful owner of mcp-ssh-toolkit-py and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A minimal Model Context Protocol (MCP) server for secure SSH automation, built with python-sdk and paramiko.
mcp-ssh-toolkit-py
A minimal Model Context Protocol (MCP) server for secure SSH automation, built with python-sdk and paramiko.
Table of Contents
Overview 🚀
mcp-ssh-toolkit-py is a powerful MCP server for secure SSH command execution via Model Context Protocol.
🔹 Key Features:
- Execute arbitrary commands on remote servers via SSH
- Upload/download files via SFTP
- Integration with Claude/Cline and other MCP clients
- Supports password and SSH key authentication
- Configurable connection parameters (timeouts, ports)
🔹 Use Cases:
- DevOps automation via LLMs
- Server management through chat interface
- Secure remote script execution
- SSH integration in MCP ecosystem
Example usage:
# Through MCP client
response = mcp.tool("ssh_execute_command", {
"host": "example.com",
"username": "user",
"command": "docker ps"
})
Features ✨
Core Functionality
- 🛡️ Secure SSH command execution via MCP
- 📁 SFTP operations (file upload/download)
- 🔑 Multiple authentication methods:
- Username/password
- SSH keys (RSA)
- SSH agent
Integration
- 🤖 Full compatibility with Claude/Cline
- 🐳 Ready-to-use Docker image
- 📦 Pip package installation
Security
- 🔒 Encrypted connections
- ⏱ Configurable timeouts
- 🚫 No credential storage
Installation 📦
Docker (Recommended)
- Clone the repository:
git clone https://github.com/VitalyMalakanov/mcp-ssh-toolkit-py.git
cd mcp-ssh-toolkit-py
- Build the Docker image:
docker build -t mcp-ssh-toolkit-py .
- (Optional) Push to your Docker registry:
docker tag mcp-ssh-toolkit-py yourusername/mcp-ssh-toolkit-py
docker push yourusername/mcp-ssh-toolkit-py
Pip Installation
Install directly from GitHub:
pip install git+https://github.com/VitalyMalakanov/mcp-ssh-toolkit-py.git
Run the server after installation:
python -m mcp_ssh_toolkit
Development Setup
For development, install with:
git clone https://github.com/VitalyMalakanov/mcp-ssh-toolkit-py.git
cd mcp-ssh-toolkit-py
pip install -e .
Quickstart
Run with Docker
docker run --rm -i mcp-ssh-toolkit-py
MCP Integration
Add to your MCP configuration (e.g., cline_mcp_settings.json):
"mcp-ssh-toolkit-py": {
"command": "docker",
"args": ["run", "--rm", "-i", "mcp-ssh-toolkit-py"],
"env": {}
}
Usage
Tool: ssh_execute_command
Description:
Execute a command on a remote server via SSH.
Input parameters:
host(string, required): SSH server addressusername(string, required): SSH usernamepassword(string, optional): SSH passwordprivateKey(string, optional): Path to SSH private key (PEM)command(string, required): Command to executeport(integer, optional, default 22): SSH porttimeout(integer, optional, default 20): Connection timeout (seconds)
Output:
stdout: Command outputstderr: Error outputexit_code: Exit code
Example call:
{
"host": "example.com",
"username": "user",
"password": "secret",
"command": "uname -a"
}
Development
- Python 3.8+
- python-sdk
- paramiko
Install dependencies locally:
pip install -r requirements.txt
Run locally:
python main.py
Security
- SSH credentials are never stored or logged.
- Always use strong passwords or SSH keys for authentication.
- Do not expose the MCP server to untrusted networks.
- Review paramiko security best practices.
- If you discover a security vulnerability, please report it via GitHub Issues or contact the maintainer privately.
License
MIT License. See for details.
