ssh-utils

ssh-utils

目的

ssh-utils は、SSH 経由でリモートサーバー上のターミナルコマンドを実行できる Model Context Protocol（MCP）サーバーです。Roo Code または MCP 対応クライアント内でツールとして使用することを想定しており、開発環境からキー認証で安全に SSH コマンドを実行できます。

仕組み

• MCP プロトコル経由で execute_ssh_command というツールを公開します。
• 呼び出されると、SSH を使用してリモートサーバーに接続し、指定されたコマンドを実行します。
• 認証情報と接続の詳細は、次の場所に配置できる設定ファイル（ssh-utils-servers.json）から読み込まれます。
  • 現在の作業ディレクトリ
  • ワークスペースのルート
  • グローバル設定ディレクトリ：~/.config/ssh-utils/ssh-utils-servers.json
• 設定に複数のプロファイルがある場合、デフォルトでは最初のプロファイルが使用されます。または、プロファイル名を指定できます。
• ユーザー、ホスト、サーバーなどのツール引数は、設定ファイルの値を上書きします。

設定ファイル

設定ファイルは ssh-utils-servers.json という名前の JSON ファイルで、構造は次のとおりです。

{
  "profiles": {
    "default": {
      "host": "example.com",
      "user": "bob",
      "port": 22,
      "privateKeyPath": "/home/bob/.ssh/id_ed25519"
    },
    "work": {
      "server": "workhost",
      "user": "alice"
    }
  }
}

• host または server：SSH ホスト名または IP アドレスです。
• user：SSH ユーザー名です。
• port：（任意）SSH ポートです（デフォルト：22）。
• privateKeyPath：（任意）秘密鍵ファイルへのパスです。

使い方

1. ssh-utils-servers.json 設定ファイルを、対応している場所のいずれかに配置します。
2. Roo Code または別の MCP クライアントから execute_ssh_command ツールを使用し、コマンドを指定します。必要に応じて、接続パラメーターを上書きできます。

セキュリティ

• セキュリティ上の理由から、パスワードを使用した SSH 認証は禁止されています。キー認証のみをサポートしています。