MCP.so
Sign In

SSH MCP Server

@KinoThe-Kafkaesque

Repository

About SSH MCP Server

this is a collection of tools that allows your agent to execute commands on your remote servers

Basic information

Category

Developer Tools

License

MIT

Runtime

node

Transports

stdio

Publisher

KinoThe-Kafkaesque

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "ssh-mcp-server-kinothe-kafkaesque": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@KinoThe-Kafkaesque/ssh-mcp-server",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

7

save `{ "name", "host", "username", "privateKeyPath" }`.

list stored credential records.

delete `{ "name" }`.

run a shell command with `{ "credentialName", "command", "timeout" }`.

run an argv-style command array, for example `{ "credentialName": "prod", "command": ["grep", "-E", "foo|bar", "/var/log/app.log"] }`.

copy one file over SFTP with `{ "credentialName", "localPath", "remotePath", "direction" }`.

copy directories or larger trees with rsync and the same transfer shape.

Overview

What is SSH MCP Server?

A Model Context Protocol (MCP) server implementation that provides SSH capabilities for secure remote access and execution. It integrates with SQLite for credential storage and is built with TypeScript. This server is aimed at developers who need to control remote machines through the MCP protocol.

How to use SSH MCP Server?

Install via Smithery (npx -y @smithery/cli install @KinoThe-Kafkaesque/ssh-mcp-server --client claude) or manually: clone the repo, run npm install, npm run build, then npm start. Start the server, then call its tools (e.g., ssh_exec, scp_copy, ssh_tunnel_start) with stored credentials. Credentials are managed through add_credential, list_credentials, remove_credential tools.

Key features of SSH MCP Server

  • SSH server implementation using MCP protocol
  • SQLite database for persistent credential storage
  • Named credential management
  • Remote shell command execution with timeout
  • SCP and rsync file transfer support
  • Interactive SSH session management
  • Local and remote port forwarding tunnels

Use cases of SSH MCP Server

  • Run shell commands on remote servers from an MCP client (e.g., Claude Desktop)
  • Transfer files between local and remote machines via SCP or rsync
  • Maintain interactive SSH sessions programmatically
  • Set up secure port forwarding tunnels for service access

FAQ from SSH MCP Server

What are the prerequisites for running SSH MCP Server?

Node.js 18 or higher, a package manager (npm or yarn), and TypeScript knowledge for development.

How are SSH credentials stored?

Credentials are stored in a SQLite database file (ssh.db), which is created automatically when the server starts.

What tools does SSH MCP Server provide for remote execution?

It provides ssh_exec (single command with timeout), ssh_exec_raw (argv-style command array), scp_copy, rsync_copy, and interactive session tools

Comments

More Developer Tools MCP servers

Burp Suite MCP Server Extension

PortSwigger

MCP Server for Burp

961

MCP Framework

QuantGeekDev

The Typescript MCP Framework

924

DevDocs by CyberAGI 🚀

cyberagiinc

Completely free, private, UI based Tech Documentation MCP server. Designed for coders and software developers in mind. Easily integrate into Cursor, Windsurf, Cline, Roo Code, Claude Desktop App

2.1K

Huoshan Test

volcengine

2.4K

Deepwiki MCP Server

regenrek

📖 MCP server for fetch deepwiki.com and get latest knowledge in Cursor and other Code Editors

1.4K