my-mcp-ssh

What is my-mcp-ssh?

my-mcp-ssh is a Model Context Protocol (MCP) based SSH connection tool that allows large language models to securely connect to remote servers via SSH and perform file operations through the MCP protocol.

How to use my-mcp-ssh?

Clone the repository, install dependencies with uv sync, then configure the MCP client with the command uv --directory <your_path>/my-mcp-ssh run src/main.py. SSH connection parameters are set via environment variables (e.g., SSH_HOST, SSH_PASSWORD). Use the provided tools (connect, disconnect, list_sessions, execute, upload, download) to manage sessions and transfer files.

Key features of my-mcp-ssh

• SSH Connection Management: connect and disconnect from remote servers
• Command Execution: run commands on remote servers
• File Transfer: upload and download files
• Session Management: maintain and list active SSH sessions
• Configurable via environment variables and command parameters
• Session timeout and output length limits configurable

Use cases of my-mcp-ssh

• Execute remote commands and retrieve output through an MCP client
• Upload or download files to/from a remote server
• Manage multiple SSH sessions from a single MCP server
• Integrate SSH operations into AI‑assisted workflows

FAQ from my-mcp-ssh

What are the runtime dependencies for my-mcp-ssh?

Python >= 3.12 and the uv package manager are required.

How do I configure SSH connection parameters?

Set environment variables such as SSH_HOST, SSH_PORT, SSH_USERNAME, and either SSH_PASSWORD (for password auth) or SSH_KEY_PATH (for key auth).

What operations can my-mcp-ssh perform?

It provides tools to connect, disconnect, list sessions, execute commands, upload files, and download files.

How can I debug the server?

Run ./inspector.sh from the project directory for online debugging.

What license does my-mcp-ssh use?

It is licensed under the Apache License, Version 2.0.