MCP SSH Manager - Model Context ProtocolによるSSHリモートサーバー管理 🚀

Claude CodeおよびOpenAI Codexが複数のSSH接続を管理できるようにするModel Context Protocol (MCP) サーバーです。AIアシスタントから直接、コマンドの実行、ファイルの転送、データベースの管理、バックアップの作成、健全性の監視、DevOpsタスクの自動化をサーバー全体で行うことができます。

🎉 v3.2.2の新機能

グローバルインストール修正とCLIバイナリ (リリース日: 2026年4月7日)

• 🔧 グローバルインストールの修正: .envパスの解決にハードコードされた__dirnameではなくフォールバックチェーンを使用するように変更 — npm install -gで正しく動作します (#16, #19)

  • フォールバックチェーン: ~/.ssh-manager/.env → cwd/.env → ~/.env → プロジェクトの.env

  • 初回のssh-manager server add実行時に~/.ssh-manager/.envを自動作成

• 📦 ssh-manager CLIがバイナリとして登録: npm install -gでmcp-ssh-managerとssh-managerの両方のコマンドが作成されるようになりました (#18)

• ⚡ レースコンディションの修正: MCPサーバーがリクエストを受け付ける前にサーバー設定が完全に読み込まれるようになりました

Related MCP server: MCP Server for FTP Access

過去のリリース

v3.2.0 - ProxyJump / Bastionホストのサポート (2026年3月18日)

• 🔀 ProxyJumpサポート: シンプルなPROXYJUMP設定フィールドを使用して、踏み台サーバー（Bastion/Jumpホスト）の背後にあるサーバーに接続可能 (#15)

  • 再帰的接続により複数のジャンプ（A → B → C）をチェーン可能

  • 循環依存関係の検出により無限ループを防止

  • すべてのツールがジャンプホスト経由で透過的に動作

• 📦 npxサポートの修正: npx mcp-ssh-managerが正しく動作するようになりました (#14)

v3.1.5 - SSHエージェントとパスフレーズのサポート (2026年3月5日)

• 🔑 SSHエージェントサポート: SSH_AUTH_SOCKが利用可能な場合に自動的にssh-agentを使用 — パスフレーズで保護されたキーも透過的に動作

• 🔐 パスフレーズ設定: .envおよびTOML形式の両方で利用可能な新しいpassphraseフィールド

オリジナルの貢献をしてくれた@snjaxに感謝します (#12)。

v3.1.4 - Windows SSHホストのサポート (2026年2月22日)

• 🪟 Windows SSHホストの修正: OpenSSHを実行しているWindowsホストでコマンドが失敗しなくなりました (#10)

• サーバーごとの新しいplatform設定フィールド (SSH_SERVER_FOO_PLATFORM=windows または TOMLで platform = "windows")

• platform=windowsの場合、Linuxのtimeout/sh -cコマンドラッパーはスキップされ、代わりにSSHライブラリのネイティブタイムアウトが使用されます

• すべてのツール (ssh_execute, ssh_tail, ssh_monitor, ssh_deploy, ssh_execute_sudo, ssh_group_execute) がプラットフォームを認識します

v3.1.2 - Windows互換性の修正 (2026年2月9日)

• 🪟 Windowsサポート: process.env.HOMEが未定義の場合にWindowsでクラッシュする問題を修正 (#8)

• クロスプラットフォーム互換性（Linux、macOS、Windows）のためにos.homedir()を使用するように変更

v3.1.0 - ツールアクティベーションシステム (2025年11月15日)

🎯 コンテキスト使用の最適化

• コンテキストを92%削減: 必要なツールのみを有効化（最小モード: 5ツール vs 全37ツール）

• ツール管理CLI: ssh-manager tools list/configure/enable/disable

• 6つのツールグループ: Core, Sessions, Monitoring, Backup, Database, Advanced

• 自動承認エクスポート: Claude Codeの自動承認設定を生成

v3.0.0 - エンタープライズDevOpsプラットフォーム (2025年10月1日)

このリリースでは12個の新しいMCPツールが追加され、SSH Managerが包括的なDevOps自動化プラットフォームへと進化しました:

💾 バックアップ＆リストアシステム (4ツール)

• MySQL, PostgreSQL, MongoDBおよびファイルシステム用の自動バックアップ

• cron統合と保持ポリシーを備えたスマートスケジューリング

• データベース間サポートを備えたワンクリックリストア

• 監査とコンプライアンスのためのメタデータ追跡

🏥 健全性と監視 (4ツール)

• CPU, RAM, ディスク, ネットワークメトリクスによるリアルタイム健全性チェック

• nginx, mysql, dockerおよびカスタムサービス用のサービス監視

• CPU/RAMソートと強制終了機能を備えたプロセス管理

• 設定可能な通知を備えたアラートしきい値

🗄️ データベース管理 (4ツール)

• 圧縮と選択的エクスポートを備えた安全なデータベースダンプ

• 自動解凍を備えたデータベースインポート

• データベース, テーブル, コレクションを一覧表示するスキーマ探索

• SQLインジェクション防止（SELECTのみ）を備えた安全なクエリ

📊 合計: 37個のMCPツール | 🔧 約4,100行のコードを追加 | ✅ 本番環境対応

完全な変更履歴を読む →

📑 目次

• 機能

• ツール管理

• 前提条件

• クイックスタート - Claude Code

• クイックスタート - OpenAI Codex

• 利用可能なMCPツール

• 設定

• 使用例

• セキュリティ

• トラブルシューティング

• 既知の制限事項

• 貢献

• ライセンス

🌟 機能

コア機能

• 🔗 複数のSSH接続 - 単一のインターフェースから無制限のSSHサーバーを管理

• 🔐 安全な認証 - パスワード、SSHキー、ssh-agent認証（パスフレーズ保護されたキーを含む）をサポート

• 🔀 ProxyJump / Bastionホスト - チェーンされたマルチホップサポートにより、ジャンプホストの背後にあるサーバーに接続

• 📁 ファイル操作 - ローカルシステムとリモートシステム間でのファイルのアップロードとダウンロード

• ⚡ コマンド実行 - 作業ディレクトリサポートを備えたリモートサーバーでのコマンド実行

• 📂 デフォルトディレクトリ - 利便性のためにサーバーごとのデフォルト作業ディレクトリを設定

• 🎯 簡単な設定 - ガイド付き設定ツールを備えたシンプルな.envファイルセットアップ

エンタープライズDevOps機能 (v3.0) 🎉

• 💾 バックアップ＆リストア - MySQL, PostgreSQL, MongoDBおよびファイル用の自動バックアップ

• 🏥 健全性監視 - リアルタイムのサーバー健全性チェック（CPU, RAM, ディスク, サービス）

• 🗄️ データベース管理 - SQLインジェクション防止を備えた安全なデータベース操作

• 📊 プロセス管理 - サーバープロセスの監視と制御

• ⚠️ スマートアラート - 設定可能な健全性しきい値と通知

v2.0の機能

• 🚀 Bash CLI - サーバー管理用の超高速な純Bash CLI

• 📊 高度なログ記録 - レベルと履歴を備えた包括的なログシステム

• 🔄 Rsync統合 - rsyncサポートによる双方向ファイル同期

• 💻 永続セッション - 複数のコマンド間でシェルコンテキストを維持

• 👥 サーバーグループ - 複数のサーバーで同時にコマンドを実行

• 🔧 SSHトンネル - ローカル/リモートポート転送およびSOCKSプロキシサポート

• 📈 システム監視 - CPU, メモリ, ディスク, ネットワークのリアルタイム監視

• 🏷️ サーバーエイリアス - 完全なサーバー名の代わりに短いエイリアスを使用

• 🚀 スマートデプロイ - 権限処理を備えた自動ファイルデプロイ

• 🔑 Sudoサポート - sudo権限でコマンドを安全に実行

• 📝 OpenAI Codexサポート - TOML設定経由でOpenAI Codexと互換性あり

⚙️ ツール管理とコンテキストの最適化

v3.1の新機能: ツールアクティベーション管理により、Claude Codeのコンテキスト使用量を92%削減！

MCP SSH Managerには、6つのグループに整理された37個のツールが含まれています。デフォルトではすべてのツールが有効になっていますが、特定のワークフローに合わせて最適化できます:

クイックセットアップ

# Interactive configuration wizard
ssh-manager tools configure

# View current configuration
ssh-manager tools list

# Enable/disable specific groups
ssh-manager tools enable monitoring
ssh-manager tools disable backup

設定モード

ツールグループ

• Core (5ツール) - 常に有効: list, execute, upload, download, sync

• Sessions (4ツール) - 永続的なSSHセッション

• Monitoring (6ツール) - 健全性チェック, サービスステータス, プロセス管理

• Backup (4ツール) - データベースおよびファイルバックアップ

• Database (4ツール) - MySQL, PostgreSQL, MongoDB操作

• Advanced (14ツール) - デプロイ, sudo, トンネル, グループ, エイリアスなど

メリット

• 最小モードで92%のコンテキスト削減 (約40kトークンを節約)

• Claude Codeでの承認プロンプトの減少

• 読み込みの高速化とクリーンなインターフェース

• Claude Code用の自動承認設定エクスポート

📖 完全なツール管理ガイド →

📋 前提条件

• Node.js (v18以上)

• npm (Node.jsに付属)

• プラットフォーム: Linux, macOS, Windows

• Claude Code用: Claude Code CLIがインストールされていること

• OpenAI Codex用: Codex CLIが設定されていること

• Bash 4.0+ (CLI管理ツール用)

• rsync (ファイル同期用)

• sshpass (オプション、パスワード認証でのrsync用)

  • macOS: brew install hudochenkov/sshpass/sshpass

  • Linux: apt-get install sshpass

🚀 クイックスタート - Claude Code

1. MCP SSH Managerのインストール

オプションA: npmからインストール (推奨)

# Install globally from npm
npm install -g mcp-ssh-manager

# Or install locally
npx mcp-ssh-manager

オプションB: ソースからインストール

# Clone and install
git clone https://github.com/bvisible/mcp-ssh-manager.git
cd mcp-ssh-manager
npm install

# Install the Bash CLI
cd cli && ./install.sh

# Configure your first server
ssh-manager server add

2. Claude Codeへのインストール

# For personal use (current user only)
claude mcp add ssh-manager node /path/to/mcp-ssh-manager/src/index.js

# For team sharing (creates .mcp.json in project)
claude mcp add ssh-manager --scope project node /path/to/mcp-ssh-manager/src/index.js

# For all your projects
claude mcp add ssh-manager --scope user node /path/to/mcp-ssh-manager/src/index.js

3. 自動承認の設定 (オプションだが推奨)

すべてのSSHコマンドで承認を求められないようにするには、自動承認設定を追加します:

~/.config/claude-code/claude_code_config.jsonを編集:

{
  "mcpServers": {
    "ssh-manager": {
      "command": "node",
      "args": ["/path/to/mcp-ssh-manager/src/index.js"],
      "autoApprove": [
        "mcp__ssh-manager__ssh_execute",
        "mcp__ssh-manager__ssh_list_servers",
        "mcp__ssh-manager__ssh_upload",
        "mcp__ssh-manager__ssh_download",
        "mcp__ssh-manager__ssh_sync",
        "mcp__ssh-manager__ssh_alias"
      ]
    }
  }
}

重要: この変更を行った後、Claude Codeを再起動してください。

すべてのSSHツールの完全な自動承認については、examples/claude-code-config.example.jsonの完全なリストを参照してください。

4. 使用開始！

Claude Codeで以下が可能になります:

"List all my SSH servers"
"Execute 'ls -la' on production server"  # Uses default directory if set
"Run 'docker ps' on staging"
"Upload config.json to production:/etc/app/config.json"
"Download logs from staging:/var/log/app.log"

デフォルトディレクトリを使用する場合: 本番環境のデフォルトとして/var/www/htmlを設定した場合、以下のコマンドは同等です:

• 「Run 'ls' on production」 → /var/www/htmlで実行

• 「Run 'ls' on production in /tmp」 → /tmpで実行 (デフォルトを上書き)

🚀 クイックスタート - OpenAI Codex

1. MCP SSH Managerのインストール

Claude Codeと同じインストール手順（上記参照）を行い、Codex用に設定します:

# Set up Codex integration
ssh-manager codex setup

# Migrate existing servers to TOML format (if you have .env servers)
ssh-manager codex migrate

# Test the integration
ssh-manager codex test

2. 手動設定 (オプション)

手動セットアップを好む場合は、~/.codex/config.tomlに追加します:

[mcp_servers.ssh-manager]
command = "node"
args = ["/absolute/path/to/mcp-ssh-manager/src/index.js"]
env = { SSH_CONFIG_PATH = "/Users/you/.codex/ssh-config.toml" }
startup_timeout_ms = 20000

3. TOML形式でサーバーを設定

~/.codex/ssh-config.tomlを作成または編集します:

[ssh_servers.production]
host = "prod.example.com"
user = "admin"
password = "secure_password"  # or use key_path
key_path = "~/.ssh/id_rsa"   # for SSH key auth (recommended)
passphrase = "key_passphrase" # optional, for passphrase-protected keys
port = 22
default_dir = "/var/www"
description = "Production server"

[ssh_servers.staging]
host = "staging.example.com"
user = "deploy"
key_path = "~/.ssh/staging_key"
port = 2222
default_dir = "/home/deploy/app"

[ssh_servers.winhost]
host = "192.168.1.90"
user = "svc-ssh"
key_path = "~/.ssh/winhost_key"
port = 2222
platform = "windows"
description = "Windows host via OpenSSH"

[ssh_servers.bastion]
host = "bastion.example.com"
user = "jumpuser"
key_path = "~/.ssh/bastion_key"

[ssh_servers.internal]
host = "10.0.0.5"
user = "admin"
key_path = "~/.ssh/internal_key"
proxy_jump = "bastion"
description = "Private server behind bastion"

💡 より完全な例についてはexamples/codex-ssh-config.example.tomlを参照してください！

4. Codexで使用開始！

OpenAI Codexで以下が可能