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: 5 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 (5 months ago)
- Default Branch: main
- Last Pushed: 2025-04-26T21:22:11.000Z (5 months ago)
- Last Synced: 2025-04-26T22:25:03.680Z (5 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
- best-of-mcp-servers - GitHub
- 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 - **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. (JavaScript)
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.