Alexgoller Illumio MCP Server

🚀 灵光 MCP サーバー

このサーバーは、灵光 PCE（ポリシー計算エンジン）とのインターフェースを提供するモデルコンテキストプロトコル（MCP）サーバーです。灵光のワークロード管理、ラベル操作、トラフィック分析に対するプログラムによるアクセスを実現します。

🚀 クイックスタート

このセクションでは、灵光 MCP サーバーの基本的なセットアップと使用方法を説明します。

✨ 主な機能

会話型 AI を使用して PCE とやり取りできます。以下の機能があります。

• ワークロードの作成、更新、削除
• ラベルの作成、更新、削除
• トラフィックの要約を取得し、セキュリティ分析を実行
• PCE のヘルス状態を取得

📦 インストール

前提条件

• Python 3.8 以上のバージョン
• 灵光 PCE インスタンスへのアクセス
• PCE の有効な API 認証情報

インストール手順

1. リポジトリをクローンします。

git clone [リポジトリのURL]
cd illumio-mcp

2. 依存関係をインストールします。

pip install -r requirements.txt

📚 ドキュメント

設定説明

uv コマンドを使用して実行することをおすすめします。これにより、環境変数を簡単に渡し、バックグラウンドで実行できます。

uv と Claude Desktop の使用

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

custom_settings セクションに以下の内容を追加します。

"mcpServers": {
    "illumio-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/alex.goller/git/illumio-mcp",
        "run",
        "illumio-mcp"
      ],
      "env": {
        "PCE_HOST": "あなたのPCEホスト名",
        "PCE_PORT": "あなたのPCEポート",
        "PCE_ORG_ID": "1", // あなたの組織ID
        "API_KEY": "api_key",
        "API_SECRET": "api_secret"
      }
    }
  }
}

機能特性

リソース

リソースはまだ完成していません。後日調査します。

• illumio://workloads - PCE からワークロードを取得
• illumio://labels - PCE からすべてのラベルを取得

ツールセット

ワークロード管理

• get-workloads - PCE 内のすべてのワークロードを取得
• create-workload - 指定された名前、IP アドレス、およびラベルを持つ未管理ワークロードを作成
• update-workload - 既存のワークロードの属性を更新
• delete-workload - 名前で PCE からワークロードを削除

ラベル操作

• create-label - キーと値のペアを使用して新しいラベルを作成
• delete-label - キーと値のペアで既存のラベルを削除
• get-labels - PCE 内のすべてのラベルを取得

トラフィック分析

• get-traffic-flows - 詳細なトラフィックデータを取得し、以下のような完全なフィルタリングオプションがあります。
  • 時間範囲のフィルタリング
  • ソース/宛先アドレスのフィルタリング
  • サービス（ポート/プロトコル）のフィルタリング
  • ポリシー決定のフィルタリング
  • ワークロードと IP リストのクエリオプション
  • 結果の制限
• get-traffic-flows-summary - トラフィックデータの要約情報を取得し、get-traffic-flows と同じフィルタリング機能を備えています。

ポリシー管理

• get-rulesets - PCE からルールセットを取得し、以下のようなオプションでフィルタリングできます。
  • 名前でのフィルタリング
  • 有効状態でのフィルタリング

IP リスト管理

• get-iplists - PCE から IP リストを取得し、以下のようなオプションでフィルタリングできます。
  • 名前でのフィルタリング
  • 説明でのフィルタリング
  • IP でのフィルタリング

トラブルシューティング

• diagnose - API 接続のチェックや認証情報の検証などのトラブルシューティング手順を実行します。

エラー処理

一般的なエラーには、無効な API 認証情報やネットワーク接続の問題があります。これらの問題を解決するには、トラブルシューティングガイド を参照してください。

セキュリティに関する注意事項

PCE の API キーを安全に保管し、漏洩を防ぐようにしてください。定期的にキーを更新し、厳格なアクセス制御を実施することをおすすめします。

貢献とフィードバック

コミュニティからの貢献とフィードバックを歓迎します。GitHub リポジトリ を通じて問題やプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT License に従い、詳細な条項は LICENSE ファイルを参照してください。

付録

環境変数の参照

💻 使用例

基本的な使用法

uvicorn main:app --reload

サーバーを起動した後、http://localhost:8000 にアクセスして API を使用できます。

以上の手順に従えば、灵光 MCP サーバーを正常に設定して使用できます。さらなる支援が必要な場合は、公式ドキュメント を参照するか、サポートチームに連絡してください。