ssh-connect MCP server

@t-suganuma

代码仓库

基本信息

分类

开发工具

传输方式

stdio

作者

t-suganuma

关于 ssh-connect MCP server

An MCP server for SSH connections and file operations.

#ssh #mcp-server #file-operations

ssh-connect MCP server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "ssh-connect-mcp-server": {
      "command": "python",
      "args": [
        "examples/ssh_example.py"
      ]
    }
  }
}

ssh-connect MCP server 工具

Connect to an SSH server

Disconnect from the SSH server

Execute a command on the SSH server

Upload a file to the SSH server

Download a file from the SSH server

List files in a directory on the SSH server

概览

What is ssh-connect MCP server?

ssh-connect MCP server is a Model Context Protocol server that provides SSH connection and file operation tools. It enables clients like Cline and Claude Desktop to connect to remote servers, execute commands, and transfer files. It uses paramiko for SSH and supports password or key-based authentication.

How to use ssh-connect MCP server?

Configure the server by setting environment variables (SSH_HOST, SSH_PORT, SSH_USERNAME, and either SSH_PASSWORD or SSH_KEY_PATH) in your MCP settings file. An example configuration uses uv to run the server. Once configured, tools such as connect, execute, upload, download, and list_files become available to the MCP client.

Key features of ssh-connect MCP server

Connect to SSH servers with password or key authentication
Execute remote commands with optional timeout (default 60 seconds)
Upload and download files between local and remote systems
List directory contents with file type and size
All connection parameters configurable via environment variables
Includes test scripts and usage examples for Cline and Claude Desktop

Use cases of ssh-connect MCP server

Automate remote server administration tasks from an MCP-enabled client
Securely transfer configuration files or logs between machines
Run ad‑hoc commands on a fleet of servers through a chat interface
Integrate remote file listing and manipulation into AI‑assisted workflows

常见问题

What authentication methods does ssh-connect MCP server support?

It supports password authentication via `SSH_PASSWORD` and private key authentication via `SSH_KEY_PATH` (with optional `SSH_KEY_PASSPHRASE`). You must provide at least one of these.

What dependencies are required to run ssh-connect MCP server?

You need to install the paramiko Python package. The project includes an `install_dependencies.sh` script to handle installation.

How do I configure the SSH connection parameters?

Set the environment variables `SSH_HOST`, `SSH_PORT` (default 22), `SSH_USERNAME`, and either `SSH_PASSWORD` or `SSH_KEY_PATH` in your MCP settings file. An example JSON configuration is provided in the repository.

How can I test the server without an actual SSH server?

Run the included test script `python tests/test_ssh_connect.py`, which uses mocking to verify core functionality without requiring a live connection.

Can I override connection parameters when using the connect tool?

Yes, the `connect` tool accepts optional parameters (`host`, `port`, `username`, `password`, `key_path`, `key_passphrase`) to override environment variables on a per‑connection basis.

开发工具分类下的更多 MCP 服务器

DocBin

Give an agent a place to put large output. Instead of returning 40k characters of a build log into the conversation, it posts the file to DocBin and hands back one short URL. Docs render with syntax highlighting and mark

Mcp-Warden

ermoluk

Local-first credential broker for MCP. AI coding agents (Claude Code, Cursor, Codex…) call APIs, SSH and databases through scoped presets; secrets stay in your OS keychain and never enter the agent's context.

Official Porkbun MCP Server

Porkbun LLC

Official Porkbun MCP server, maintained by Porkbun. Check domain availability and pricing, register, renew and transfer domains, and manage DNS records, nameservers, URL forwarding, glue records, DNSSEC and domain contac

Casefile

azimov777

One case file per task — shared by every session, agent and person that touches it. Self-hosted MCP server and live board. MIT.