SSH MCP Server

AIクライアントにあなたのサーバーを安全に操作させる —— SSHベースのMCPサーバー

標準化されたMCPツールを通じてリモートでコマンド実行とファイル転送を行います。Web管理コンソールとWindowsトレイアプリを内蔵。

できること

Claude Code、CursorなどMCPプロトコルに対応したAIクライアントをあなたのSSHサーバーに接続すれば、AIは次のことができます：

• ⚙️ コマンド実行 —— リモート運用・保守、ログ調査、サービス管理

• 📤 アップロード / 📥 ダウンロード —— 設定配布、ログ取得、大容量ファイルのレジューム転送

• 🖥️ 複数マシン管理 —— プロジェクト → 環境 → ホストの3階層ツリー。一度設定すればどこでも利用可能

2つの利用形態から選択できます：

Related MCP server: sshops

✨ コア機能

接続機能

• 🔐 多様な認証：パスワード / 秘密鍵（暗号化秘密鍵含む）/ SSH Agent / キーボードインタラクティブ 2FA

• 🔗 SOCKS5とHTTP(S)プロキシ。踏み台ネットワークを透過

• 🚄 デュアル転送モード：

  • exec —— コマンドごとに1チャネル。標準Linuxホスト

  • shell —— 永続セッション + マーカープロトコル。バスティオンホスト / 踏み台サーバーに適合

• ⏱️ 接続 / コマンド / SFTPの各タイムアウトを個別に制御可能。大容量ファイルはfastPut/fastGetによる分割・並行転送

セキュリティポリシー

• コマンドのホワイトリスト / ブラックリスト（正規表現）。ホストレベルとグローバルレベルの二重フィルタリング

• ローカルとリモートのパスホワイトリストでファイル転送範囲を制限

• 完全な監査ログ：コマンド、出力、転送記録を追跡可能

Web管理コンソール

• プロジェクト-環境-ホストの3階層ビジュアル管理。接続のドラッグ＆ドロップ並べ替え

• 接続テスト、JSON一括インポート/エクスポート、~/.ssh/configの自動再利用

• 定期バックアップスナップショットとワンクリック復元。MCPクライアント（Claude Codeなど）のワンクリック登録

• ライト/ダークのデュアルテーマ。システム設定に追従して切り替え

Windowsデスクトップアプリ

• 🎯 純粋なトレイ常駐の単一exe：SSHサービス、MCP Server、Admin静的サイトをすべて内蔵。Node.js依存なし

• 起動時自動起動、シャットダウン時まで常駐。「管理ページを開く」でシステム標準ブラウザを直接起動

• 🔄 オンライン自動更新：minisignによる署名検証を内蔵。新バージョンを自動検出してサイレントアップグレード

📸 画面紹介

接続管理 —— 3階層ツリーで全ホストを管理：

システムページ —— サービス状態とMCPクライアントのワンクリック登録：

🚀 クイックスタート

方法1：Windowsデスクトップアプリ

ReleasesからSSH-MCP-Server_x.x.x_x64-setup.exeをダウンロードしてインストールします。起動後はシステムトレイに常駐し、トレイメニューの「管理ページを開く」でWebコンソールに入ります。

インストール済みユーザーは、その後のアップグレードが自動的に完了し、手動操作は不要です。

方法2：npmパッケージ（stdio MCP Server）

# 全局安装
npm install -g @sieop/ssh-mcp-server

MCPクライアントに登録します（Claude Codeを例に）：

claude mcp add ssh-server -- ssh-mcp-server --host your.server.com --username root --password YOUR_PWD

またはJSON設定を直接記述：

{
  "mcpServers": {
    "ssh-server": {
      "command": "npx",
      "args": ["-y", "@sieop/ssh-mcp-server", "--host", "your.server.com", "--username", "root", "--password", "YOUR_PWD"]
    }
  }
}

設定ファイルとマルチ接続モードにも対応しています。詳細はdocs/migration.mdとCLIヘルプ（--help）を参照してください。

方法3：ソースからビルド

git clone https://github.com/SIE-Operations-and-Maintenance-Team/ssh-mcp-server.git
cd ssh-mcp-server && npm install

npm run build                 # 构建 Node 版
npm test                      # 运行测试
npm --prefix admin-web install && npm --prefix admin-web run build   # 构建管理台前端
npm run tauri:build           # 构建 Windows 桌面应用（需 Rust 工具链）

🧰 MCPツール一覧

🏗️ アーキテクチャ

┌─ Windows 桌面应用（Tauri 2 纯托盘单 exe）──────────────────┐
│                                                            │
│  SSH 连接池 ── MCP StreamableHTTP (/mcp)                   │
│      │                                                     │
│  Admin API (/admin/api/*) ── 内嵌静态站点 (/admin/)        │
│                                                            │
└────────────────── 系统默认浏览器打开管理页 ────────────────┘

Node 版（npm 包）：stdio MCP Server ＋ 可选 --admin 启动同一套 Web 管理台

主要モジュール：src/services/ssh-connection-manager.ts（SSHコア）、src/server/（Fastify Adminサービス）、src-tauri/（Rustデスクトップシェル）、admin-web/（React管理コンソール）。

📋 その他のドキュメント

• 利用・移行ガイド —— 各クライアントの接続設定

• 更新ログ

📄 ライセンス

ISC © SIE Operations and Maintenance Team

本プロジェクトはclassfang/ssh-mcp-serverをベースに、再構築と拡張を行ったものです。