MCP Linux Administration Ssh Openwebui Tool

🚀 MCP Server - SSH Linux Control for OpenWebUI

OpenWebUIから直接SSHを介してLinux仮想マシンを制御でき、破壊的なコマンドに対して自動的に安全性チェックを行います。

🚀 クイックスタート

1. 仮想マシンの設定

サンプル設定ファイルをコピーして編集します。

cp config.yaml.example config.yaml
nano config.yaml  # または好みのエディタを使用

仮想マシンを追加します。

hosts:
  vm1:
    hostname: "192.168.1.100"
    username: "root"
    password: "yourpassword"
    description: "My Server"

2. サーバーの起動

docker compose up -d --build

3. OpenWebUIネットワークへの接続

# OpenWebUIネットワーク名を探す
docker network ls | grep openwebui

# コンテナを接続する（'openwebui_default'を実際のネットワーク名に置き換える）
docker network connect openwebui_default ssh-control-mcp

4. OpenWebUIへのツール追加

1. OpenWebUIを開き、Workspace → Tools を選択します。
2. + Create Tool をクリックします。
3. ssh_linux_control.py の全内容をコピーして貼り付けます。
4. Save をクリックします。

完了です！ 🎉

💻 使用例

OpenWebUIに以下のように問い合わせます。

• "List my VMs"
• "Connect to vm1 and check disk space"
• "Show memory usage on vm1"
• "Run 'systemctl status nginx' on my server"

✨ 主な機能

✅ パスワードベースのSSH認証（キー不要）
✅ 破壊的なコマンドの自動検出
✅ スードサポート（設定ファイルのパスワードを使用）
✅ 40種類以上の破壊的なコマンドパターンを検出
✅ コマンドのリアルタイム出力

破壊的コマンドの安全性

rm -rf、shutdown、systemctl stop などのコマンドは明示的な確認が必要です。

• 初回試行時：警告が表示されます。
• confirmed=True を指定して再試行すると実行されます。

トラブルシューティング

ツールがサーバーに接続できない場合

# コンテナが実行中か確認する
docker ps | grep ssh-control-mcp

# ログを確認する
docker logs ssh-control-mcp

# APIをテストする
curl http://localhost:3000/api/hosts

OpenWebUIがコンテナ化されている場合、両方のコンテナが同じネットワーク上にあることを確認します。

docker network connect <openwebui-network> ssh-control-mcp

ファイル構造

• config.yaml.example - サンプル設定ファイル（コミットしても安全）
• config.yaml - 仮想マシンの認証情報（.gitignoreされており、コミットしないでください）
• ssh_linux_control.py - OpenWebUIツールファイル
• docker-compose.yml - コンテナ設定ファイル
• src/ssh_control_mcp/ - MCPサーバーとHTTPラッパー

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

⚠️ 重要提示

config.yaml を決してコミットしないでください。このファイルには平文のパスワードが含まれています。

⚠️ 重要提示

config.yaml.example をテンプレートとして使用してください。

⚠️ 重要提示

このツールは信頼できるネットワーク上のローカル仮想マシン管理用に設計されています。

📄 ライセンス

MITライセンス - 詳細は LICENSE ファイルを参照してください。