M2m MCP Server Ssh Client

🚀 MCP サーバー SSH クライアント

MCP サーバー SSH クライアントは、MCP サーバーへの SSH 接続を容易にするツールです。簡単な設定でサーバーに接続でき、高度な設定オプションも用意されています。

🚀 クイックスタート

MCP サーバー SSH クライアントを使うためには、まずインストールする必要があります。以下のコマンドを実行してインストールします。

pip install mcp-server-ssh-client

インストールが完了したら、以下のコマンドを実行してクライアントを起動します。

uvx mcp_server_ssh_client --host <ホスト名> --port <ポート番号>

📦 インストール

MCP サーバー SSH クライアントをインストールするには、以下のコマンドを実行します。

pip install mcp-server-ssh-client

💻 使用例

基本的な使用法

uvx mcp_server_ssh_client --host <ホスト名> --port <ポート番号>

高度な使用法

カスタムキーを使用する場合

uvx mcp_server_ssh_client --host example.com --port 2222 --key-file /path/to/my_key

カスタム設定ファイルを使用する場合

{
  "host": "example.com",
  "port": 22,
  "key_file": "~/.ssh/id_ed25519",
  "known_hosts": "~/.ssh/known_hosts",
  "log_level": "warning"
}

uvx mcp_server_ssh_client --config ~/.config/mcpx.json

📚 ドキュメント

設定オプション

基本設定

• --host または -h: 接続先の SSH サーバーのホスト名または IP アドレスを指定します。
• --port または -p: 接続先の SSH サーバーのポート番号を指定します。デフォルトは 22 です。
• --key-file または -k: 認証に使用する秘密鍵ファイルのパスを指定します。デフォルトは ~/.ssh/id_ed25519 です。
• --known_hosts または -K: 既知のホストファイルのパスを指定します。デフォルトは ~/.ssh/known_hosts です。
• --config または -c: カスタム設定ファイルのパスを指定します。
• --log-level または -l: ログレベルを設定します。選択肢は debug、info、warning、error、critical で、デフォルトは warning です。

詳細説明

デフォルトの SSH 設定ファイルの使用

MCP サーバー SSH クライアントは、デフォルトで標準の SSH 設定ファイルを使用します。

• 秘密鍵ファイル: ~/.ssh/id_ed25519
• 既知のホストファイル: ~/.ssh/known_hosts

これらのファイルが存在し、適切な権限（600）を持っていることを確認してください。

カスタムキーの使用

複数の SSH キーペアがあり、特定のキーを使用して認証したい場合は、--key-file オプションを指定します。

uvx mcp_server_ssh_client --host example.com --port 2222 --key-file /path/to/my_key

設定ファイルの形式

カスタム設定ファイル（例: ~/.config/mcpx.json）を作成して、デフォルト値を指定することができます。

{
  "host": "example.com",
  "port": 22,
  "key_file": "~/.ssh/id_ed25519",
  "known_hosts": "~/.ssh/known_hosts",
  "log_level": "warning"
}

🔧 技術詳細

開発ガイド

依存関係のインストール

MCP サーバー SSH クライアントを開発するには、まず必要な依存関係をインストールする必要があります。

pip install mcp-server-ssh-client[dev]

デバッグモードの起動

開発やデバッグ時には、デバッグログレベルを有効にすることができます。

uvx mcp_server_ssh_client --host example.com --port 22 --log-level debug

⚠️ セキュリティに関する注意事項

• 本番環境では常にホストキー検証を有効にしてください。
• パスフレーズ付きの SSH キーを使用してセキュリティを強化してください。
• MCP 接続には専用の SSH キーを使用することを検討してください。
• 適切なファイル権限（600）を設定して SSH キーファイルを保護してください。
• リモートサーバーでは制限付きの権限を持つ専用ユーザーを使用してください。

🛠️ トラブルシューティング

接続が拒否された場合

エラーメッセージ:

MCP SSH クライアントを実行中にエラーが発生しました: [Errno 111] 接続が拒否されました

解決策: ホスト名とポート番号が正しいことを確認し、SSH サービスが実行中であることを確認してください。

認証に失敗した場合

エラーメッセージ:

MCP SSH クライアントを実行中にエラーが発生しました: 認証に失敗しました

解決策: キーファイルのパスを確認してください。リモートサーバーに公開鍵がインストールされていることを確認してください。

キー検証に失敗した場合

エラーメッセージ:

MCP SSH クライアントを実行中にエラーが発生しました: 秘密鍵ファイルが無効または使用できません

解決策: 秘密鍵ファイルが存在し、適切な権限（600）を持っていることを確認してください。chmod 600 ~/.ssh/id_ed25519 を使用して権限の問題を修正してみてください。

📄 ドキュメントの貢献

このプロジェクトにドキュメントやコードを貢献したい場合は、GitHub リポジトリ の CONTRIBUTING.md ファイルを参照してください。

MCP サーバー SSH クライアントをご利用いただき、ありがとうございます！何か問題や提案があれば、GitHub で issue または pull request を送信してください。