Ssh Hub

🚀 ssh - hub

SSHを介してAIコーディングエージェントにリモートマシンへの完全なアクセスを提供するMCPサーバーです。MCPツールインターフェイスを通じて、複数のサーバーに同時に接続し、リモートファイル操作、シェルコマンド、ディレクトリ同期を行うことができます。

🚀 クイックスタート

# 1. リモートサーバーを追加する
ssh - hub add <SERVER_ALIAS> user@host

# 2. プロジェクトでMCPとして登録する
ssh - hub mcp - install /path/to/project

接続文字列の形式

user@host                  # デフォルトのポート22、パス ~
user@host:/path            # 明示的なパス
user@host:2222             # カスタムポート、パス ~
user@host:2222:/path       # カスタムポートとパス

認証ファイル

パスフレーズで保護されたキーの場合、add 時に -i を渡すと、ssh - hub がキーをSSHエージェントにロードします。

注意: 秘密鍵にアクセスするためにパスフレーズが必要な場合、このコマンドは ssh - add を介してパスフレーズを要求し、安全に保存します。

ssh - hub add <SERVER_ALIAS> user@host - i ~/.ssh/my_key

✨ 主な機能

• 複数のサーバーに同時に接続できる。
• リモートファイル操作、シェルコマンド、ディレクトリ同期が可能。
• 自動的に構成されたサーバーに接続する機能。
• 様々なリモート操作コマンドを提供する。

📦 インストール

cargo install --git https://github.com/Perceptron - Studios/ssh - hub.git

アップグレード

ssh - hub upgrade

💻 使用例

基本的な使用法

# 1. リモートサーバーを追加する
ssh - hub add <SERVER_ALIAS> user@host

# 2. プロジェクトでMCPとして登録する
ssh - hub mcp - install /path/to/project

高度な使用法

# パスフレーズで保護されたキーを使用してサーバーを追加する
ssh - hub add <SERVER_ALIAS> user@host - i ~/.ssh/my_key

📚 ドキュメント

CLIコマンド

オプション: -v 詳細ログ出力、-i <path> 認証ファイル、-p <port> ポートオーバーライド。

mcp - install フラグ: --claude (.mcp.json のみ)、--codex (.codex/config.toml のみ)。デフォルトは両方。

MCPツール

すべてのツールは初回使用時に自動的に構成されたサーバーに接続します。手動での接続手順は必要ありません。各ツールは、構成されたサーバー名を参照する server パラメータを受け取ります。

検出

• list_servers — 構成されたサーバーを、ライブ到達可能性プローブ（遅延付きのTCPピング）で表示する

リモート操作

• remote_bash — シェルコマンドを実行する（オプションのタイムアウトとバックグラウンドモード付き）
• remote_read — ファイル内容を読み取る（大きなファイルの場合はオフセット/制限付き）
• remote_write — ファイルに内容を書き込む
• remote_edit — 文字列置換を使用してファイルを編集する
• remote_glob — グロブパターンに一致するファイルを検索する

同期

• sync_push — ローカルファイルまたはディレクトリをリモートにプッシュする（ディレクトリの場合はtarストリーミング）
• sync_pull — リモートファイルまたはディレクトリをローカルにプルする（ディレクトリの場合はtarストリーミング）

認証

すべての認証はSSHキーベースです。パスワードは保存または送信されません。キーは以下の順序で試行されます。

1. 認証ファイル — add 時に -i で指定されたキー（最も高い優先度）
2. SSHエージェント — ssh - add を介してロードされたキー、署名は ssh - agent に委任される（最大10個のキー）
3. デフォルトキー — ~/.ssh/id_ed25519、id_rsa、id_ecdsa

RSAキーは、SHA - 256/SHA - 512署名で自動的にネゴシエートされます（最新のサーバーは古いSHA - 1を拒否します）。

設定

サーバーの設定は ~/.config/ssh - hub/servers.toml（macOS: ~/Library/Application Support/ssh - hub/servers.toml）に保存されます。

[servers.staging]
host = "staging.example.com"
user = "deploy"
port = 2222
remote_path = "/var/www/app"
identity = "~/.ssh/id_staging"

[servers.prod]
host = "prod.example.com"
user = "deploy"
remote_path = "~"

📄 ライセンス

MIT