Illumio MCP Server

🚀 Illumio MCP サーバー

Illumio MCP (Micro Control Plane) は、Illumioのセキュリティポリシーを管理するためのコントロールプレーンです。Illumio PCE（Policy Control Engine）とのインターフェースを提供し、Dockerコンテナでの実行もサポートしています。

✨ 主な機能

• Claude Desktopとの統合：設定により、Illumio MCPサーバーをClaude Desktop環境に統合できます。
• Dockerサポート：コンテナの初期化や自動クリーンアップを含む、完全なDockerランタイムサポートを提供します。
• ログ記録：実行ログを指定ディレクトリに出力でき、監視やデバッグが容易になります。

使用シーン

• セキュリティポリシー管理：Illumioのセキュリティポリシーの管理と設定に使用します。
• 自動化運用：スクリプトや自動化ツールでIllumio MCPサーバーのインターフェースを呼び出せます。
• 開発テスト：Docker Composeをサポートし、開発者が迅速に環境を構築してテストできます。

📦 インストール

環境要件

• オペレーティングシステム：Linux、macOSをサポート
• Dockerバージョン：Docker 1.20以上が必要
• illumio PCE：illumio PCEサービスが利用可能である必要があります

イメージの取得

最新バージョンのイメージを取得するには、以下のコマンドを実行します。

docker pull ghcr.io/alexgoller/illumio-mcp-server:latest

特定のバージョンを使用する場合は、タグを指定します。

docker pull ghcr.io/alexgoller/illumio-mcp-server:1.0.0

💻 使用例

Claude Desktopとの統合

コンテナをClaude Desktopに統合するには、以下の手順に従ってください。

1. 環境変数ファイル（例：~/.illumio-mcp.env）を作成し、以下の内容を記述します。

PCE_HOST=your-pce-host
PCE_PORT=your-pce-port
PCE_ORG_ID=1
API_KEY=your-api-key
API_SECRET=your-api-secret

2. Claude Desktopの設定ファイル（例：MacOSの ~/Library/Application Support/Claude/claude_desktop_config.json）に以下の設定を追加します。

{
    "mcpServers": {
        "illumio-mcp-docker": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--init",
                "--rm",
                "-v",
                "/Users/YOUR_USERNAME/tmp:/var/log/illumio-mcp",
                "-e",
                "DOCKER_CONTAINER=true",
                "-e",
                "PYTHONWARNINGS=ignore",
                "--env-file",
                "/Users/YOUR_USERNAME/.illumio-mcp.env",
                "illumio-mcp:latest"
            ]
        }
    }
}

注意事項

• YOUR_USERNAME を実際のユーザー名に置き換えてください。
• ログディレクトリ（例：~/tmp）を作成してください。
• 必要に応じてパスを調整してください。

単独実行

コンテナを直接実行するには、以下のコマンドを使用します。

docker run -i --init --rm \
  -v /path/to/logs:/var/log/illumio-mcp \
  -e DOCKER_CONTAINER=true \
  -e PYTHONWARNINGS=ignore \
  --env-file /Users/YOUR_USERNAME/.illumio-mcp.env \
  illumio-mcp:latest

Docker Composeの使用

Docker Composeを使用する場合は、以下の例を参考にしてください。

version: '3'
services:
  illumio-mcp:
    image: ghcr.io/alexgoller/illumio-mcp-server:latest
    volumes:
      - /path/to/logs:/var/log/illumio-mcp
    environment:
      - DOCKER_CONTAINER=true
      - PYTHONWARNINGS=ignore
    env_file: /Users/YOUR_USERNAME/.illumio-mcp.env

🔧 技術詳細

既知の問題

• ログパスの問題：指定したログディレクトリが存在し、書き込み権限があることを確認してください。
• 環境変数の設定：すべての環境変数を正しく入力しないと、PCEへの接続に失敗することがあります。

まとめ

Illumio MCPサーバーは、Illumioのセキュリティポリシーを管理する強力なツールです。Dockerコンテナでのデプロイにより、様々な環境で簡単に使用でき、Claude Desktopとの統合もサポートしています。