mcp-ssh-toolkit-py
About
mcp-ssh-toolkit-py is a powerful MCP server for secure SSH command execution via Model Context Protocol.
Details
- License
- MIT
Explore
- Secure SSH command execution via MCP
- SFTP file upload and download
- Multiple authentication methods (password, SSH keys, SSH agent)
- Full compatibility with Claude/Cline
- Ready-to-use Docker image and pip package
- Configurable connection parameters (timeouts, ports)
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
mcp-ssh-toolkit-pyCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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
For development, install with:
git clone https://github.com/VitalyMalakanov/mcp-ssh-toolkit-py.git
cd mcp-ssh-toolkit-py
pip install -e .
---
host
(string, required): SSH server address
username
(string, required): SSH username
password
(string, optional): SSH password
privateKey
(string, optional): Path to SSH private key (PEM)
command
(string, required): Command to execute
port
(integer, optional, default 22): SSH port
timeout
(integer, optional, default 20): Connection timeout (seconds)
stdout
Command output
stderr
Error output
exit_code
Exit code
A minimal Model Context Protocol (MCP) server for secure SSH automation, built with python-sdk and paramiko.
---
Description:
Execute a command on a remote server via SSH.
Input parameters:
- host (string, required): SSH server address
- username (string, required): SSH username
- password (string, optional): SSH password
- privateKey (string, optional): Path to SSH private key (PEM)
- command (string, required): Command to execute
- port (integer, optional, default 22): SSH port
- timeout (integer, optional, default 20): Connection timeout (seconds)
Output:
- stdout: Command output
- stderr: Error output
- exit_code: Exit code
Example call:
{
"host": "example.com",
"username": "user",
"password": "secret",
"command": "uname -a"
}
---
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp-ssh-toolkit-py": {
"mcp-ssh-toolkit-py": {
"command": "docker",
"args": [
"build",
"-t",
"mcp-ssh-toolkit-py",
"."
]
}
}
}
}McpServers
{
"mcp-ssh-toolkit-py": {
"command": "docker",
"args": [
"build",
"-t",
"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
- Features
- Installation
- Quickstart
- Usage
- Development
- License
---
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:
```python
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
