MCP Ssh Toolkit Py

🚀 mcp-ssh-toolkit-py

mcp-ssh-toolkit-py is a lightweight Model Context Protocol (MCP) server based on python-sdk and paramiko, designed for secure automation via SSH. It offers a robust solution for securely executing remote SSH commands through the Model Context Protocol (MCP).

🚀 Quick Start

mcp-ssh-toolkit-py is a powerful MCP server for securely executing remote SSH commands via the Model Context Protocol (MCP).

Key Features

• Execute arbitrary commands on remote servers via SSH.
• Upload/download files (SFTP).
• Integrate with Claude/Cline and other MCP clients.
• Support password and SSH key authentication.
• Configurable connection parameters (timeout, port).

Use Cases

• DevOps automation with LLMs.
• Server management chat interfaces.
• Secure remote script execution.
• Integration of SSH in the MCP ecosystem.

Example Usage:

# Through the MCP client
response = mcp.tool("ssh_execute_command", {
    "host": "example.com",
    "username": "user",
    "command": "docker ps"
})

✨ Features

Core Features

• 🛡️ Securely execute SSH commands via MCP.
• 📁 Support file upload and download operations.
• 🔐 Support multiple authentication methods (password, SSH key).
• ⚙️ Configurable connection parameters (timeout, port, etc.).

Technical Features

• Implement the SSH protocol using paramiko.
• Integrate python-sdk to provide MCP support.
• Support asynchronous operations for improved performance.

📦 Installation

Install Dependencies

pip install -r requirements.txt

Quick Run

python main.py

💻 Usage Examples

Basic Usage

The following is an example of quickly executing a remote command through the MCP tool:

{
  "host": "example.com",
  "username": "user",
  "password": "secret",
  "command": "uname -a"
}

Return Results

• stdout: Command output.
• stderr: Error output.
• exit_code: Exit code.

🔧 Technical Details

Development Environment

• Environment Requirements: Python 3.8+
• Dependency Management:

pip install -r requirements.txt

Main Modules

1. main.py: The main program entry point to start the MCP service.
2. ssh_handler.py: Handle SSH connections and command execution.
3. file_handler.py: Handle file upload and download operations.

⚠️ Important Note

• Do not store SSH credentials in code or plain text logs.
• Always use strong passwords or SSH keys for authentication.
• Avoid exposing the MCP server to untrusted network environments.
• Refer to paramiko security best practices.
• If you discover a security vulnerability, please report it through GitHub Issues or contact the maintainer privately.

📄 License

This project is licensed under the MIT License. For more details, see the LICENSE file.