SSH MCP Server

@KinoThe-Kafkaesque

About SSH MCP Server

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

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

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

Frequently asked questions

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

Basic information

More Developer Tools MCP servers

mcp-excalidraw

yctimlin

MCP server and Claude Code skill for Excalidraw — programmatic canvas toolkit to create, edit, and export diagrams via AI agents with real-time canvas sync.

2.1K

TranscriptFetch MCP Server

TranscriptFetch

Model Context Protocol (MCP) server for TranscriptFetch: fetch YouTube transcripts, search, channels, and playlists from any MCP client.

MCP Unity Editor (Game Engine)

CoderGamester

Model Context Protocol (MCP) plugin to connect with Unity Editor — designed for Cursor, Claude Code, Codex, Windsurf and other IDEs

1.8K

Serena

oraios

A powerful MCP toolkit for coding, providing semantic retrieval and editing capabilities - the IDE for your agent

26.2K

Smithery CLI

smithery-ai

Install, manage and develop MCP servers and skills for agents

788