MCPgee
MCPgee
MCPgeeMCPgee

SSH

v1.0.0•Developer Tools•stable

A Model Context Protocol (MCP) server that provides SSH access to remote servers, allowing AI tools like Claude Desktop or VS Code to securely connect to your VPS.

ssh-mcpmcpai-integration
Share:
41
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is SSH?

SSH is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol (mcp) server that provides ssh access to remote servers, allowing ai tools like claude desktop or vs code to securely connect to your vps.

A Model Context Protocol (MCP) server that provides SSH access to remote servers, allowing AI tools like Claude Desktop or VS Code to securely connect to your VPS.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A Model Context Protocol (MCP) server that provides SSH acce

Use Cases

Securely connect to remote VPS through MCP.
Execute remote commands with Claude Desktop or VS Code.
mixelpixx

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 19, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx ssh-mcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use SSH

SSH MCP is a Model Context Protocol server that gives AI assistants like Claude Desktop direct SSH access to remote servers, enabling secure command execution, file transfers via SFTP, and even serial console connections to network switches. Beyond basic SSH, it includes built-in tools for managing Ubuntu servers, network switches, and firmware upgrades — all from within your AI client. Developers and sysadmins use it to automate VPS management without leaving their AI workflow.

Prerequisites

  • Node.js 18 or higher installed on your local machine
  • SSH access credentials (password or private key) for your target remote server
  • Claude Desktop, VS Code with MCP support, or another MCP-compatible client
  • Git to clone the repository (no npm package published; must build from source)
  • Compatible USB-to-Serial adapter (FTDI, Prolific, Silicon Labs, or CH340) if using serial console features
1

Clone the repository

Clone the SSH-MCP repository from GitHub to your local machine.

git clone https://github.com/mixelpixx/SSH-MCP.git
cd SSH-MCP
2

Install dependencies and build

Install Node.js dependencies and compile the TypeScript source to JavaScript.

npm install
npm run build
3

Locate the built server file

After building, the server entry point will be at dist/index.js (or build/index.js). Note the absolute path to this file — you will need it in the MCP client configuration.

ls $(pwd)/dist/index.js
4

Configure Claude Desktop

Add the server to your Claude Desktop MCP configuration file. Replace /absolute/path/to/SSH-MCP with the actual directory path on your system.

{
  "mcpServers": {
    "ssh-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/SSH-MCP/dist/index.js"],
      "env": {
        "NODE_NO_WARNINGS": "1"
      }
    }
  }
}
5

Restart your MCP client

Quit and reopen Claude Desktop (or reload your VS Code window) so it picks up the new server configuration.

6

Test the connection

Ask Claude to connect to your server. It will use the ssh_connect tool with your provided credentials, then you can run commands with ssh_exec.

SSH Examples

Client configuration

Claude Desktop config block for SSH MCP. Set NODE_NO_WARNINGS to suppress Node.js runtime warnings.

{
  "mcpServers": {
    "ssh-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/SSH-MCP/dist/index.js"],
      "env": {
        "NODE_NO_WARNINGS": "1"
      }
    }
  }
}

Prompts to try

Example prompts that exercise SSH MCP's tools including connection, command execution, and file transfer.

- "Connect to example.com as user 'deploy' using my SSH key at ~/.ssh/id_rsa"
- "Run 'df -h' on the remote server and show me disk usage"
- "Upload ~/build/app.tar.gz to /var/www/app/ on the server"
- "List files in /var/log/ on the server"
- "Check the status of nginx and restart it if it is not running"

Troubleshooting SSH

Connection refused or timeout when using ssh_connect

Verify the remote host, port (default 22), and that your firewall allows SSH. For key-based auth, ensure the private key path is correct and the corresponding public key is in ~/.ssh/authorized_keys on the remote server.

Module not found error when starting the server

Make sure you ran both 'npm install' and 'npm run build' before pointing your MCP client at dist/index.js. The TypeScript must be compiled first.

Claude does not see the ssh-mcp tools

Check that the absolute path in your config points to the compiled index.js, not the TypeScript source. Restart Claude Desktop fully after editing the config file.

Frequently Asked Questions about SSH

What is SSH?

SSH is a Model Context Protocol (MCP) server that model context protocol (mcp) server that provides ssh access to remote servers, allowing ai tools like claude desktop or vs code to securely connect to your vps. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install SSH?

Follow the installation instructions on the SSH GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with SSH?

SSH works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is SSH free to use?

Yes, SSH is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

SSH Alternatives — Similar Developer Tools Servers

Looking for alternatives to SSH? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.

Ecc

★ 188.2k

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Javaguide

★ 155.8k

Java 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Gemini CLI

★ 104.5k

A secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in

Awesome MCP Servers

★ 87.3k

⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.

MCP Servers

★ 86.0k

Model Context Protocol Servers

CC Switch

★ 77.5k

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Developer ToolsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "ssh-mcp": { "command": "npx", "args": ["-y", "ssh-mcp"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use SSH?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides