Auto Om

🚀 auto-om - Linux自動化運用管理MCPサーバー

Linux自動化運用管理のための包括的なモデルコンテキストプロトコル（MCP）サーバーです。このMCPサーバーは、SSH接続を通じてLinuxサーバーを効率的に管理するための8カテゴリ74以上のツールを提供します。

English | 简体中文

🚀 クイックスタート

auto-omは、Linux自動化運用管理のための包括的なMCPサーバーです。このサーバーを使用することで、SSH接続を通じてLinuxサーバーを効率的に管理できます。

✨ 主な機能

ツールカテゴリ（合計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

🔧 設定

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}"

💻 使用例

サーバーの起動

# 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

Dockerの使用

# docker-composeで実行
docker-compose up

# dockerで実行
docker run -p 8000:8000 \
  -v $(pwd)/application.yaml:/app/application.yaml \
  auto-om:latest

ドキュメント

様々な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. 音声またはテキストコマンドでサーバー管理を行う

クイックスタート

提供されているスクリプトを使用します。

# Linux/macOS
./scripts/start.sh

# Windows
scripts\start.bat

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"
      }
    }
  }
}

基本的な使用法

ファイル管理

{
  "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
}

🔧 技術詳細

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接続管理が行われます。
• 出力制限：過剰な応答を防ぎます。

サポートされているLinuxディストリビューション

• Debian 10以上
• Ubuntu 18.04以上
• CentOS 7以上
• RHEL 7以上
• Fedora 30以上

依存関係

• Python 3.11以上
• paramiko 3.5.0 (SSH2プロトコル)
• mcp 1.25.0 (モデルコンテキストプロトコル)
• pyyaml 6.0.3 (YAML設定)

開発

# 開発用の依存関係をインストール
pipenv install --dev

# テストを実行 (利用可能な場合)
pytest tests/

# コードを整形
black src/

# 型チェック
mypy src/

バージョン履歴

詳細なバージョン履歴については、VERSION.mdを参照してください。

コントリビュート

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. 変更を加える
4. プルリクエストを送信する

📄 ライセンス

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

サポート

問題や質問については、以下の場所を参照してください。

• GitHub Issues: https://github.com/atoncooper/auto-om/issues
• ドキュメント: VERSION.md

謝辞

• MCP Python SDKを使用して構築されています。
• 一般的なLinux自動化ツールに触発されています。