Observium MCP

🚀 Observium MCP Server

Model Context Protocol (MCP) サーバーです。このサーバーは、Observium CE のネットワーク監視データを Claude などの大規模言語モデル (LLM) に公開し、デバイスの状態、ネットワークトラフィック、センサーの読み取り値、アラート、および履歴トレンドに関する自然言語クエリを可能にします。

✨ 主な機能

• デバイス管理：状態、稼働時間、ハードウェア情報を含む監視対象デバイスの一覧表示とクエリ
• ネットワークポート：インターフェースの状態、トラフィックレート、および利用率の表示
• センサー：温度、電圧、周波数などのセンサーデータへのアクセス
• アラート：アクティブおよび履歴アラートの一覧表示と要約
• トレンド：RRD データから履歴メトリクス (負荷、CPU、メモリ) を取得

📦 インストール

1. リポジトリをクローンする

git clone https://github.com/kdesch5000/observium-mcp.git
cd observium-mcp

2. 仮想環境を作成する

python3 -m venv venv
source venv/bin/activate

3. 依存関係をインストールする

pip install -r requirements.txt

4. 環境を設定する

サンプル設定ファイルをコピーし、Observium データベースの資格情報を編集します。

cp config.example.env .env

.env ファイルを設定に合わせて編集します。

# データベース接続 (リモートの場合は SSH トンネルを使用)
OBSERVIUM_DB_HOST=localhost
OBSERVIUM_DB_PORT=3306
OBSERVIUM_DB_NAME=observium
OBSERVIUM_DB_USER=observium
OBSERVIUM_DB_PASS=your_database_password

# RRD データのパス (Observium サーバー上)
OBSERVIUM_RRD_PATH=/opt/observium/rrd

# オプション: リモート RRD アクセスのための SSH 設定
# MCP サーバーが Observium とは別のマシンで実行されている場合、
# トレンドデータのための SSH ベースの RRD ファイルアクセスを有効にするためにこれらを設定します
# OBSERVIUM_RRD_SSH_HOST=observium.example.com
# OBSERVIUM_RRD_SSH_USER=pi
# OBSERVIUM_RRD_SSH_PORT=22

💻 使用例

Claude Code での使用

Claude Code の MCP 設定 (~/.claude/claude_code_config.json) に追加します。

{
  "mcpServers": {
    "observium": {
      "command": "python",
      "args": ["-m", "observium_mcp.server"],
      "cwd": "/path/to/observium-mcp/src",
      "env": {
        "OBSERVIUM_DB_HOST": "localhost",
        "OBSERVIUM_DB_NAME": "observium",
        "OBSERVIUM_DB_USER": "observium",
        "OBSERVIUM_DB_PASS": "your_password",
        "OBSERVIUM_RRD_PATH": "/opt/observium/rrd"
      }
    }
  }
}

Claude Desktop での使用

Claude Desktop の設定に追加します。

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "observium": {
      "command": "python",
      "args": ["-m", "observium_mcp.server"],
      "cwd": "/path/to/observium-mcp/src",
      "env": {
        "OBSERVIUM_DB_HOST": "your_observium_host",
        "OBSERVIUM_DB_NAME": "observium",
        "OBSERVIUM_DB_USER": "observium",
        "OBSERVIUM_DB_PASS": "your_password",
        "OBSERVIUM_RRD_PATH": "/opt/observium/rrd"
      }
    }
  }
}

スタンドアロンでの使用

cd src
python -m observium_mcp.server

📚 詳細ドキュメント

利用可能なツール

クエリの例

接続後、Claude に以下のような質問をすることができます。

• "現在ダウンしているデバイスはどれですか？"
• "メインスイッチの温度センサーを表示してください"
• "過去 1 週間のファイアウォールの CPU 負荷トレンドはどうですか？"
• "アクティブなアラートはありますか？"
• "コアスイッチのどのポートにエラーがありますか？"
• "すべての Linux サーバーの稼働時間はどれくらいですか？"

リモートアクセス

Observium インスタンスがリモートサーバー上にある場合、いくつかのオプションがあります。

オプション 1: SSH トンネル

# MySQL ポートを転送する SSH トンネルを作成する
ssh -L 3306:localhost:3306 user@observium-server

# 次に .env を localhost で設定する
OBSERVIUM_DB_HOST=localhost

オプション 2: Observium サーバーにインストールする

MCP サーバーを直接 Observium ホストにインストールし、Claude が SSH で接続するように設定します。

オプション 3: ネットワークアクセス

MySQL がネットワーク上でアクセス可能な場合 (セキュリティ上推奨されません)。

OBSERVIUM_DB_HOST=observium.example.com

セキュリティに関する考慮事項

• データベースの資格情報は .env に保存され、git 管理から除外されています。
• サーバーは SELECT クエリのみを実行します (読み取り専用)。
• 追加のセキュリティのために、読み取り専用の MySQL ユーザーを使用することを検討してください。
• RRD アクセスは rrdtool fetch を通じて読み取り専用です。

読み取り専用データベースユーザーの作成

追加のセキュリティのために、専用の読み取り専用 MySQL ユーザーを作成します。

CREATE USER 'observium_mcp'@'localhost' IDENTIFIED BY 'secure_password';
GRANT SELECT ON observium.* TO 'observium_mcp'@'localhost';
FLUSH PRIVILEGES;

トラブルシューティング

接続拒否

• MySQL が実行中でアクセス可能かを確認します。
• .env のデータベース資格情報を確認します。
• MySQL ユーザーに SELECT 権限があることを確認します。

RRD データがない / トレンドツールが機能しない

• OBSERVIUM_RRD_PATH が Observium サーバー上の正しいディレクトリを指していることを確認します。
• MCP を別のマシンで実行している場合は、SSH アクセスを設定します。
  • OBSERVIUM_RRD_SSH_HOST を Observium サーバーのホスト名に設定します。
  • OBSERVIUM_RRD_SSH_USER を SSH アクセス権のあるユーザーに設定します。
  • SSH キーベースの認証が設定されていることを確認します。
• Observium サーバー (リモートの場合) またはローカルに rrdtool がインストールされていることを確認します。
• RRD ディレクトリのファイル権限を確認します。

モジュールが見つからない

src ディレクトリから実行するか、パッケージをインストールしていることを確認します。

cd /path/to/observium-mcp/src
python -m observium_mcp.server

🤝 コントリビューション

コントリビューションは大歓迎です！問題やプルリクエストを自由に送信してください。

📄 ライセンス

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

🙏 謝辞

• Observium - ネットワーク監視プラットフォーム
• Model Context Protocol - MCP 仕様
• Anthropic - Claude と MCP の開発