https://github.com/tufantunc/ssh-mcp
MCP server exposing SSH control for Linux servers via Model Context Protocol.
https://github.com/tufantunc/ssh-mcp
Last synced: 11 months ago
JSON representation
MCP server exposing SSH control for Linux servers via Model Context Protocol.
- Host: GitHub
- URL: https://github.com/tufantunc/ssh-mcp
- Owner: tufantunc
- License: mit
- Created: 2025-04-26T21:07:32.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-04-26T21:22:11.000Z (11 months ago)
- Last Synced: 2025-04-26T22:25:03.680Z (11 months ago)
- Language: TypeScript
- Size: 17.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-mcp-servers - tufantunc/ssh-mcp
- awesome-mcp - tufantunc/ssh-mcp
- awesome-mcp-servers - ssh-mcp - An MCP server that exposes SSH control for Linux and Windows servers via the Model Context Protocol, enabling secure remote command execution and server management. ([Read more](/details/ssh-mcp.md)) `ssh` `remote-execution` `server-management` (Server Management Tools)
- best-of-mcp-servers - GitHub - 53% open · ⏱️ 03.01.2026) (Command Line)
- awesome-mcp-servers - **ssh-mcp** - MCP server exposing SSH control for Linux servers via Model Context Protocol. `remote` `http` `git` `github` `javascript` `npm install tufantunc/ssh-mcp` (📦 Other)
- awesome-mcp-servers - tufantunc/ssh-mcp - モデルコンテキストプロトコル経由でLinuxおよびWindowsサーバーのSSH制御を公開するMCPサーバー。パスワードまたはSSHキー認証でリモートシェルコマンドを安全に実行。 (サーバー実装 / 🖥️ <a name="command-line"></a>コマンドライン)
- awesome-ccamel - tufantunc/ssh-mcp - MCP server exposing SSH control for Linux servers via Model Context Protocol. (TypeScript)
- awesome-mcp-servers - tufantunc/ssh-mcp - モデルコンテキストプロトコル経由でLinuxおよびWindowsサーバーのSSH制御を公開するMCPサーバー。パスワードまたはSSHキー認証でリモートシェルコマンドを安全に実行。 (サーバー実装 / 🖥️ <a name="command-line"></a>コマンドライン)
- awesome-mcp - tufantunc/ssh-mcp - This project is an MCP server that enables Large Language Models (LLMs) and other MCP clients to execute shell commands securely over SSH on remote Linux and Windows servers. (MCP Servers / Other MCP Servers)
README
# SSH MCP Server
[](./LICENSE)
[](https://www.npmjs.com/package/ssh-mcp)
**SSH MCP Server** is a local Model Context Protocol (MCP) server that exposes SSH control for Linux and Windows systems, enabling LLMs and other MCP clients to execute shell commands securely via SSH.
## Contents
- [Quick Start](#quick-start)
- [Features](#features)
- [Installation](#installation)
- [Client Setup](#client-setup)
- [Testing](#testing)
- [Disclaimer](#disclaimer)
- [Support](#support)
## Quick Start
- [Install](#installation) SSH MCP Server
- [Configure](#configuration) SSH MCP Server
- [Set up](#client-setup) your MCP Client (e.g. Claude Desktop, Cursor, etc)
- Execute remote shell commands on your Linux or Windows server via natural language
## Features
- MCP-compliant server exposing SSH capabilities
- Execute shell commands on remote Linux and Windows systems
- Secure authentication via password or SSH key
- Built with TypeScript and the official MCP SDK
### Tools
- `exec`: Execute a shell command on the remote server
## Installation
1. **Clone the repository:**
```bash
git clone https://github.com/tufantunc/ssh-mcp.git
cd ssh-mcp
```
2. **Install dependencies:**
```bash
npm install
```
## Client Setup
You can configure Claude Desktop to use this MCP Server.
- `host`: Hostname or IP of the Linux or Windows server
- `port`: SSH port (default: 22)
- `user`: SSH username
- `password`: SSH password (or use `key` for key-based auth) (optional)
- `key`: Path to private SSH key (optional)
```commandline
{
"mcpServers": {
"ssh-mcp": {
"command": "npx",
"args": [
"ssh-mcp",
"-y",
"--",
"--host=1.2.3.4",
"--port=22",
"--user=root",
"--password=pass",
"--key=path/to/key"
]
}
}
}
```
## Testing
You can use the [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector) for visual debugging of this MCP Server.
```sh
npm run inspect
```
## Disclaimer
SSH MCP Server is provided under the [MIT License](./LICENSE). Use at your own risk. This project is not affiliated with or endorsed by any SSH or MCP provider.
## Support
If you find SSH MCP Server helpful, consider starring the repository or contributing! Pull requests and feedback are welcome.