Auto Om

🚀 auto-om - Linux自動化運維管理MCP服務器

auto-om是一個全面的用於Linux自動化運維管理的模型上下文協議（MCP）服務器。該MCP服務器通過SSH連接，提供了8大類、74種以上的工具，可高效管理Linux服務器。

🚀 快速開始

你可以通過以下方式快速啟動auto-om服務器：

從源碼安裝

# 克隆倉庫
git clone https://github.com/atoncooper/auto-om.git
cd auto-om

# 使用pipenv安裝依賴
pipenv install

# 激活虛擬環境
pipenv shell

# 或者直接使用pip安裝
pip install -r requirements.txt

使用Docker

# 構建Docker鏡像
docker build -t auto-om:latest .

# 或者使用docker-compose
docker-compose up -d

啟動服務器

# 以stdio模式運行（默認，適用於MCP客戶端）
python main.py

# 以HTTP模式運行
python main.py --mode http

# 使用自定義主機/端口運行
python main.py --mode http --host 127.0.0.1 --port 9000

# 使用自定義配置
python main.py --config /path/to/config.yaml

使用腳本快速啟動

# Linux/macOS
./scripts/start.sh

# Windows
scripts\start.bat

✨ 主要特性

工具類別（共88個工具）

關鍵能力

• 文件操作：創建、複製、移動、刪除文件和目錄
• 文本處理：查看、搜索、轉換文本文件，支持正則表達式
• 系統監控：即時監控CPU、內存、磁盤和進程
• 進程控制：終止、發送信號和管理進程優先級
• 網絡診斷：執行ping、traceroute、DNS、HTTP測試和端口掃描
• 壓縮：創建和提取tar、zip、gzip、bzip2、xz歸檔文件
• 包管理：安裝、刪除、更新軟件包（apt、yum、dnf）

📦 安裝指南

前提條件

• Python 3.11或更高版本
• pip和pipenv
• 具有SSH訪問權限的Linux服務器

從源碼安裝

# 克隆倉庫
git clone https://github.com/atoncooper/auto-om.git
cd auto-om

# 使用pipenv安裝依賴
pipenv install

# 激活虛擬環境
pipenv shell

# 或者直接使用pip安裝
pip install -r requirements.txt

使用Docker

# 構建Docker鏡像
docker build -t auto-om:latest .

# 或者使用docker-compose
docker-compose up -d

💻 使用示例

文件管理

{
  "host": "server1",
  "path": "/home/user/documents"
}

系統監控

{
  "host": "server1",
  "human_readable": true
}

進程控制

{
  "host": "server1",
  "pid": 1234,
  "signal": "TERM"
}

網絡診斷

{
  "host": "server1",
  "destination": "google.com",
  "count": 5
}

包管理

{
  "host": "server1",
  "packages": "nginx",
  "dry_run": true
}

📚 詳細文檔

配置

創建一個application.yaml文件：

# 傳輸模式: "stdio" 或 "http"
transport:
  mode: http

# HTTP設置（適用於http模式）
http:
  host: 0.0.0.0
  port: 8000

# SSH連接池
ssh_pool:
  default_timeout: 30
  max_retries: 3
  connection_timeout: 10
  retry_delay: 5
  max_connections: 10

  # 添加你的Linux服務器
  servers:
    - host: "192.168.1.100"
      port: 22
      username: "your_username"
      password: "your_password"
      alias: "server1"

⚠️ 安全警告：在生產環境中使用環境變量存儲敏感數據：

export SSH_PASSWORD="your_password"

然後在YAML中引用它：

servers:
  - host: "192.168.1.100"
    username: "your_username"
    password: "${SSH_PASSWORD}"

與各種AI開發工具集成的完整文檔

使用AI工具快速開始

Claude Code（CLI）

# 安裝Claude Code
npm install -g @anthropic-ai/claude-code

# 在~/.config/Claude/claude_desktop_config.json中配置
# 然後使用: claude-code "Check server status on server1"

Cursor（IDE）

1. 打開Cursor設置
2. 導航到MCP部分
3. 添加服務器: http://localhost:8000/sse
4. 在Cursor的AI聊天中開始使用工具

Trae（移動）

1. 安裝Trae應用（iOS/Android）
2. 添加MCP服務器: http://your-server-ip:8000/sse
3. 使用語音或文本命令進行服務器管理

MCP客戶端集成

使用Postman MCP

1. 安裝Postman MCP客戶端
2. 添加MCP服務器: http://your-server:8000/sse
3. 工具將自動發現

使用Claude Desktop

添加到claude_desktop_config.json：

{
  "mcpServers": {
    "auto-om": {
      "command": "python",
      "args": ["/path/to/auto-om/main.py"],
      "env": {
        "PYTHONPATH": "/path/to/auto-om"
      }
    }
  }
}

🔧 技術細節

架構

auto-om/
├── main.py                 # 入口點
├── application.yaml        # 配置文件
├── requirements.txt        # Python依賴項
├── Dockerfile             # 容器定義
├── docker-compose.yml     # 多容器設置
├── src/
│   ├── core/              # 核心MCP功能
│   │   ├── server.py      # MCP服務器實現
│   │   └── ssh_client.py  # SSH連接池
│   └── tools/             # 工具實現
│       ├── file_mgr.py        # 文件管理（12個工具）
│       ├── text_proc.py        # 文本處理（11個工具）
│       ├── system_monitor.py   # 系統監控（11個工具）
│       ├── process_mgr.py      # 進程管理（10個工具）
│       ├── network_ops.py      # 網絡操作（14個工具）
│       ├── compress_ops.py     # 壓縮（8個工具）
│       └── package_mgr.py      # 包管理（7個工具）
├── VERSION.md             # 版本歷史
└── README.md              # 本文件

安全特性

• 非根用戶操作：所有操作均為非根用戶設計
• 路徑驗證：禁止對系統目錄進行操作
• 命令驗證：阻止危險命令
• 預運行模式：在執行破壞性操作之前進行預覽
• 連接池管理：安全的SSH連接管理
• 輸出限制：防止響應過大

📄 許可證

本項目採用MIT許可證 - 詳情請參閱LICENSE文件。

支持

如有問題或疑問：

• GitHub問題跟蹤：https://github.com/atoncooper/auto-om/issues
• 文檔：VERSION.md

致謝

• 使用MCP Python SDK構建
• 受常見Linux自動化工具啟發