mcp-ssh-toolkit-py

mcp-ssh-toolkit-py

python-sdk と paramiko で構築された、安全な SSH 自動化のための軽量な Model Context Protocol（MCP）サーバーです。

---

目次

• 概要
• 機能
• インストール
• クイックスタート
• 使い方
• 開発
• ライセンス

---

概要 🚀

mcp-ssh-toolkit-py は、Model Context Protocol を介した安全な SSH コマンド実行のための強力な MCP サーバーです。

🔹 主な機能：

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

🔹 ユースケース：

• LLM を利用した DevOps 自動化
• チャットインターフェースによるサーバー管理
• 安全なリモートスクリプト実行
• MCP エコシステムにおける SSH 連携

使用例：

# Through MCP client
response = mcp.tool("ssh_execute_command", {
    "host": "example.com",
    "username": "user",
    "command": "docker ps"
})

---

機能 ✨

コア機能

• 🛡️ MCP を介した安全な SSH コマンド実行
• 📁 SFTP 操作（ファイルのアップロード／ダウンロード）
• 🔑 複数の認証方式：
  • ユーザー名／パスワード
  • SSH キー（RSA）
  • SSH エージェント

連携

• 🤖 Claude/Cline と完全互換
• 🐳 すぐに使える Docker イメージ
• 📦 Pip パッケージのインストール

セキュリティ

• 🔒 暗号化された接続
• ⏱ タイムアウトを設定可能
• 🚫 認証情報を保存しない

---

インストール 📦

Docker（推奨）

1. リポジトリをクローンします：

git clone https://github.com/VitalyMalakanov/mcp-ssh-toolkit-py.git
cd mcp-ssh-toolkit-py

2. Docker イメージをビルドします：

docker build -t mcp-ssh-toolkit-py .

3. （任意）Docker レジストリにプッシュします：

docker tag mcp-ssh-toolkit-py yourusername/mcp-ssh-toolkit-py
docker push yourusername/mcp-ssh-toolkit-py

Pip によるインストール

GitHub から直接インストールします：

pip install git+https://github.com/VitalyMalakanov/mcp-ssh-toolkit-py.git

インストール後にサーバーを起動します：

python -m mcp_ssh_toolkit

開発環境のセットアップ

開発用には、次のコマンドでインストールします：

git clone https://github.com/VitalyMalakanov/mcp-ssh-toolkit-py.git
cd mcp-ssh-toolkit-py
pip install -e .

---

クイックスタート

Docker で実行

docker run --rm -i mcp-ssh-toolkit-py

MCP 連携

MCP 設定（例：cline_mcp_settings.json）に追加します：

"mcp-ssh-toolkit-py": {
  "command": "docker",
  "args": ["run", "--rm", "-i", "mcp-ssh-toolkit-py"],
  "env": {}
}

---

使い方

ツール：ssh_execute_command

説明：
SSH を介してリモートサーバー上でコマンドを実行します。

入力パラメーター：

• host（文字列、必須）：SSH サーバーのアドレス
• username（文字列、必須）：SSH ユーザー名
• password（文字列、任意）：SSH パスワード
• privateKey（文字列、任意）：SSH 秘密鍵（PEM）へのパス
• command（文字列、必須）：実行するコマンド
• port（整数、任意、デフォルト 22）：SSH ポート
• timeout（整数、任意、デフォルト 20）：接続タイムアウト（秒）

出力：

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

呼び出し例：

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

---

開発

• Python 3.8+
• python-sdk
• paramiko

依存関係をローカルにインストールします：

pip install -r requirements.txt

ローカルで実行します：

python main.py

---

セキュリティ

• SSH 認証情報は保存も記録もされません。
• 認証には、必ず強力なパスワードまたは SSH キーを使用してください。
• MCP サーバーを信頼できないネットワークに公開しないでください。
• paramiko のセキュリティに関するベストプラクティスを確認してください。
• セキュリティ上の脆弱性を発見した場合は、GitHub Issues から報告するか、メンテナーに非公開で連絡してください。

---

ライセンス

MIT ライセンスです。詳細は LICENSE を参照してください。