MCP Ssh Toolkit Py

🚀 mcp-ssh-toolkit-py

mcp-ssh-toolkit-py は、python-sdk と paramiko に基づく軽量なモデルコンテキストプロトコル（MCP）サーバーで、SSH を通じた安全な自動化を実現します。

🚀 クイックスタート

概要

mcp-ssh-toolkit-py は、モデルコンテキストプロトコル（MCP）を通じて、安全にリモートの SSH コマンドを実行するための強力な MCP サーバーです。

主な機能

• SSH を介してリモートサーバーで任意のコマンドを実行
• ファイルのアップロード/ダウンロード (SFTP)
• Claude/Cline や他の MCP クライアントとの統合
• パスワードと SSH キーによる認証をサポート
• 接続パラメータ（タイムアウト、ポート）の設定可能

利用例

• LLM による DevOps 自動化
• サーバー管理用のチャットインターフェース
• 安全なリモートスクリプト実行
• MCP エコシステム内での SSH の統合

基本的な使用法

# MCP クライアントを通じた使用例
response = mcp.tool("ssh_execute_command", {
    "host": "example.com",
    "username": "user",
    "command": "docker ps"
})

✨ 主な機能

コア機能

• 🛡️ MCP を通じて安全に SSH コマンドを実行
• 📁 ファイルのアップロードとダウンロード操作をサポート
• 🔐 複数の認証方式（パスワード、SSH キー）をサポート
• ⚙️ 接続パラメータ（タイムアウト、ポートなど）の設定可能

技術的な特徴

• paramiko を使用して SSH プロトコルを実装
• python-sdk を統合して MCP サポートを提供
• 非同期操作をサポートし、パフォーマンスを向上

📦 インストール

依存関係のインストール

pip install -r requirements.txt

すぐに実行する

python main.py

💻 使用例

基本的な使用法

以下は、MCP ツールを使用してリモートコマンドをすぐに実行する例です。

{
  "host": "example.com",
  "username": "user",
  "password": "secret",
  "command": "uname -a"
}

戻り値

• stdout: コマンドの出力
• stderr: エラー出力
• exit_code: 終了コード

📚 ドキュメント

開発環境

• 環境要件：Python 3.8 以上
• 依存関係の管理：

  pip install -r requirements.txt
  

主要なモジュール

1. main.py：メインプログラムのエントリーポイントで、MCP サービスを起動します。
2. ssh_handler.py：SSH 接続とコマンド実行を処理します。
3. file_handler.py：ファイルのアップロードとダウンロード操作を処理します。

🔧 技術詳細

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

• SSH の資格情報をコードや平文のログに保存しないでください。
• 常に強力なパスワードまたは SSH キーを使用して認証してください。
• MCP サーバーを信頼できないネットワーク環境に公開しないでください。
• paramiko のセキュリティベストプラクティスを参照してください。
• セキュリティホールを発見した場合は、GitHub Issues または直接メンテナに連絡して報告してください。

📄 ライセンス

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