MCP Linux Administration Ssh Openwebui Tool

🚀 MCP 服務器 - 用於 OpenWebUI 的 SSH Linux 控制

通過 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 → 工作區 → 工具
2. 點擊 + 創建工具
3. 複製並粘貼 ssh_linux_control.py 的全部內容
4. 保存

大功告成！🎉

💻 使用示例

向 OpenWebUI 提問：

• "列出我的虛擬機"
• "連接到 vm1 並檢查磁盤空間"
• "顯示 vm1 的內存使用情況"
• "在我的服務器上運行 'systemctl status nginx'"

✨ 主要特性

✅ 基於密碼的 SSH 認證（無需密鑰）
✅ 自動檢測破壞性命令
✅ 支持 sudo（使用配置文件中的密碼）
✅ 檢測 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 文件。