SSHリモートMCPサーバー

Model Context Protocol (MCP) を介した、MCP互換クライアント向けのSSHリモートアクセス。

クイックスタート

1. インストール:

   pip install -r requirements.txt

2. Claude DesktopまたはClaude CodeにMCPを追加:

   MCP設定を使用して、コマンドを以下のように設定します:

   python3 adremote-mcp/ssh_mcp_server.py

   または

   python.exe adremote-mcp/ssh_mcp_server.py

3. CodexにMCPを追加:

   CodexのMCP設定に同じサーバーを追加します:

   python3 adremote-mcp/ssh_mcp_server.py

4. 自動セットアップ:

   このリポジトリをダウンロードし、ClaudeまたはCodexを実行して、このフォルダーをグローバルMCPサーバーとして追加するように指示してください。 その後、チャットから直接使用できるようになります。

機能

• WindowsおよびLinuxのMCP互換クライアントで動作

• SSH経由でリモートサーバーに接続

• ネイティブなSSHジャンプホスト/踏み台サーバーのサポート

• リモートでのコマンド実行

• SFTP経由でのファイルのアップロード/ダウンロード

• 複数の接続の管理

• ヘルスモニタリング

使用例

パスワードで接続:

Connect to 192.168.1.100 with username ubuntu and password mypass

または短縮形式:

ssh 192.168.1.100:22 ubuntu mypass

MCPはまず、ユーザー名とパスワードを使用してSSH接続をテストします。 ログインが成功すると、SSHキーを生成またはインストールし、キーベースの認証情報をローカルに保存します。パスワードは保存されません。 パスワードは初回のみ使用されます。

一時的なセッションでパスワードを使用して接続:

ssh 192.168.1.100:22 ubuntu mypass, save_credentials false

これにより、ライブ接続のみが維持されます。再利用可能な認証情報は保存されず、自動的なキーのブートストラップも試行されません。

保存された名前を使用して後で接続:

ssh saved-name

最初のセットアップが成功した後は、保存された認証情報名を使用して再度接続するだけです。

ジャンプホスト経由で接続:

ssh_connect または ssh_save_credentials で jump_host オブジェクトを使用します:

{
  "hostname": "10.0.2.15",
  "username": "ubuntu",
  "private_key_path": "~/.ssh/id_ed25519",
  "jump_host": {
    "hostname": "203.0.113.10",
    "username": "bastion",
    "private_key_path": "~/.ssh/id_ed25519",
    "port": 22
  }
}

これはターゲットホストへのネイティブなSSHトンネルを使用し、保存された認証情報は同じジャンプホスト設定を保持します。 再利用可能な保存済み認証情報の場合、ジャンプホストはパスワードではなく private_key_path を使用する必要があります。

コマンドの実行:

List files in /home directory on my server
Run 'top' command on the remote server
Execute script.py and monitor its log

ファイル転送:

Upload local file.txt to /home/user/ on the server
Download /var/log/app.log from the server

接続の健全性とインベントリ:

Check health of all SSH connections
Show me all active SSH connections

要件

• Python 3.10以上

• paramiko

• mcp

最新のアップデート

バージョン 1.0.1 では、より安全で実用的な日常のSSHワークフローが追加されました:

• 直接ログインでは引き続き再利用可能な認証情報がデフォルトで保存されますが、save_credentials=false を指定することで、パスワードセッションでも保存を明示的に無効化できるようになりました

• 保存された認証情報のフローには、接続、保存、一覧表示、削除、および手動キーセットアップのヘルパーが含まれるようになりました

• ホストの信頼性とファイル転送ルールが厳格化され、ローカルルートの制限と初回接続時のホスト信頼（Trust-on-first-use）による固定が行われます

• ネイティブなジャンプホスト接続が、ライブセッションと保存された認証情報の両方でサポートされました

• 保存された認証情報はキーベースであるため、通常の使用にマスターパスワードは不要です

• 手動で保存された秘密鍵のパスは、初回接続時ではなく、保存時に検証されるようになりました

サポート

協力についてはご連絡ください。