MCP Server SSH Client

A Model Context Protocol Server (Remote SSH client) that connects to remote MCP servers over SSH. This client enables accessing and utilizing MCP tools hosted on remote servers, providing a secure channel for MCP communication.

Features

• Connect to any MCP server over SSH
• Proxy all MCP protocol commands through a secure SSH channel
• Support for key-based authentication
• Support for MCP capabilities including tools, prompts, and resources

Installation

In a uv managed python project, add to dependencies by:

uv add m2m-mcp-server-ssh-client

Alternatively, for projects using pip for dependencies:

pip install m2m-mcp-server-ssh-client

To install directly from the source:

git clone https://github.com/Machine-To-Machine/m2m-mcp-server-ssh-client.git
cd m2m-mcp-server-ssh-client
pip install -e .

To run the server inside your project:

uv run m2m-mcp-server-ssh-client

Common Use Cases

1. Quick Start with Demo Server

We maintain a public demo server with various MCP tools already configured and ready to use. (This server will be available until we release our open, decentralized registry.)

This demo server has multiple MCP servers including HackerNews, MLB Stats API, and Formula 1 API tools for you to experiment with.

Claude

To connect Claude to this server, simply add the following to Claude Desktop settings.

"mcpServers": {
  "remote-mcp-tools": {
    "command": "uvx",
    "args": [
      "m2m-mcp-server-ssh-client", 
      "--host", "mcp-beta.machinetomachine.ai", 
      "--port", "8022", 
      "--use-key-server"
    ]
  }
}

Command-line

# Connect to the M2M public demo server with automatic key exchange
uv run m2m-mcp-server-ssh-client --host mcp-beta.machinetomachine.ai --use-key-server

2. Local Development Testing

For setting up your own SSH server, refer to m2m-mcp-server-ssh-server.

For local testing with your own MCP tools:

# Connect to a local MCP SSH server
uv run m2m-mcp-server-ssh-client

The above command will try to connect to a local SSH server listening on port 8022.

When testing locally, you can simplify key exchange by using the key server: