M2m MCP Server Ssh Server

🚀 MCP サーバー SSH

MCP サーバー SSH は、安全な SSH アクセスを提供するツールで、キー管理機能をサポートしています。クライアントは SSH プロトコルを介してサーバーに接続でき、付属の HTTP キー管理サーバーを使用してクライアント公開鍵の登録プロセスを簡素化することができます。

🚀 クイックスタート

MCP サーバー SSH を使用することで、安全な SSH アクセスとキー管理を行うことができます。以下に、基本的な使い方を説明します。

📦 インストール

コマンドラインでの実行

uv run m2m-mcp-server-ssh-server --help

パラメータオプション

⚠️ 重要提示

すべてのインターフェイス（0.0.0.0）にバインドする場合、システムにアクセスできるすべてのマシンからサーバーにアクセスできるようになります。強力な認証を使用し、ファイアウォールなどの追加のセキュリティ対策を検討してください。

✨ 主な機能

キー管理サーバー

HTTP キー管理サーバーを選択的に実行して、クライアントキーの登録を簡素化することができます。

uv run m2m-mcp-server-ssh-server --run-key-server

これにより、以下が起動します：

• SSH サーバーが 8022 ポートでリッスンします。
• キー管理 HTTP サーバーが 8000 ポートでリッスンします（デフォルトでは localhost のみ）。

キー管理 API

キー管理サーバーは以下のインターフェイスを提供します：

1. POST /register - クライアント公開鍵を登録します。

   • リクエストボディ：{"client_pub_key": "ssh-rsa AAAA..."}
   • レスポンス：{"status": "success"} またはエラーメッセージ

2. GET /server_pub_key - サーバーの公開鍵を取得します。

   • レスポンス：{"server_pub_key": "ssh-ed25519 AAAA..."}

3. GET /health - サーバーの健全性をチェックします。

   • レスポンス：{"status": "healthy"}

クライアントキー登録の例

curl -X POST -H "Content-Type: application/json" \
  -d '{"client_pub_key": "ssh-rsa AAAA..."}' \
  http://localhost:8000/register

🔧 技術詳細

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

• セキュリティを向上させるため、デフォルトでは localhost（127.0.0.1）にバインドされます。
• （提供されない場合）自動的に安全な権限を持つキーが生成されます。
• デフォルトのキーの場所は ~/.ssh/m2m_mcp_server_ssh_server です。
• 秘密鍵は 0644 の権限で保護されます。
• クライアントの IP アドレスのホワイトリスト制限をサポートしています。

依存関係

• Python 3.8 以上
• pip パッケージマネージャー
• cryptography ライブラリ（暗号化操作に使用）

開発環境の設定

git clone https://github.com/yourusername/mcp-server-ssh.git
cd mcp-server-ssh
pip install -r requirements.txt
python main.py --help

コントリビューションガイド

コードの提出

1. プロジェクトリポジトリを Fork します。
2. 機能ブランチを作成します：git checkout -b feature/new-feature
3. 変更をコミットします：git commit -m "新機能の追加"
4. ブランチにプッシュします：git push origin feature/new-feature
5. Pull Request を作成します。

開発規約

1. PEP8 コードスタイルガイドに従います。
2. 単体テストケースを追加します。
3. ドキュメントを更新してください。
4. 提出する前にフォーマットチェックを実行します：black .

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。