ssh-connect MCP server logo

ssh-connect MCP server

by t-suganuma

An MCP server designed for managing SSH connections and performing file operations on remote servers. It provides tools for connecting, disconnecting, executing commands, and transferring files via SSH.

View on GitHub

Last updated: N/A

What is ssh-connect MCP server?

This is an MCP (Model Context Protocol) server that enables SSH connections and file operations on remote servers. It provides a set of tools for managing SSH sessions and interacting with remote file systems.

How to use ssh-connect MCP server?

The server is configured using environment variables for SSH connection parameters (host, port, username, password/key). It can be integrated with Cline or Claude Desktop. Example scripts are provided to demonstrate usage, including connecting, executing commands, uploading/downloading files, and listing directory contents.

Key features of ssh-connect MCP server

  • Connect to an SSH server with configurable parameters

  • Execute commands on the SSH server and retrieve output

  • Upload and download files between local and remote systems

  • List files in a directory on the SSH server

  • Disconnect from the SSH server

  • Supports password or key-based authentication

Use cases of ssh-connect MCP server

  • Automated SSH tasks

  • Remote file management

  • Scripted server administration

  • Integration with AI tools like Cline or Claude Desktop

  • Securely accessing and managing remote servers

FAQ from ssh-connect MCP server

What authentication methods are supported?

The server supports both password and SSH key-based authentication. You must provide either SSH_PASSWORD or SSH_KEY_PATH in the configuration.

How do I configure the SSH connection parameters?

SSH connection parameters are configured using environment variables such as SSH_HOST, SSH_PORT, SSH_USERNAME, SSH_PASSWORD, SSH_KEY_PATH, and SSH_KEY_PASSPHRASE.

How do I test the SSH MCP server?

The repository provides example scripts and a test script (test_ssh_mcp.py) to verify the server's functionality. You can also use the provided shell script (test_ssh_mcp.sh) for testing with Cline.

How do I install the SSH MCP server in Cline or Claude Desktop?

Automatic installation scripts (install_ssh_mcp.py and install_ssh_mcp_claude.py) are provided. Alternatively, you can manually configure the server by adding it to the mcpServers object in the Cline or Claude Desktop configuration file.

What is the MCP Inspector and how do I use it?

The MCP Inspector is a debugging tool for MCP servers. You can launch it using npx @modelcontextprotocol/inspector uv --directory /path/to/ssh-connect run ssh-connect and access it in your browser via the displayed URL.