Illumio MCP Server

🚀 Illumio MCP 服務器

Illumio MCP（微控制平面）是一款用於管理 Illumio 安全策略的控制平面。它提供了與 Illumio PCE（策略控制引擎）交互的接口，並且支持通過 Docker 容器化運行，為安全策略管理帶來了極大的便利。

✨ 主要特性

• 集成 Claude Desktop：可通過配置將 Illumio MCP 服務器集成到 Claude Desktop 環境中，拓展使用場景。
• Docker 支持：提供完整的 Docker 運行時支持，涵蓋容器初始化和自動清理功能，簡化部署流程。
• 日誌記錄：支持將運行日誌輸出到指定目錄，便於進行監控和調試工作。

📦 安裝指南

環境要求

• 操作系統：支持 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

📚 詳細文檔

使用場景

• 安全策略管理：用於管理和配置 Illumio 的安全策略。
• 自動化運維：可以通過腳本或自動化工具調用 Illumio MCP 服務器的接口。
• 開發測試：提供 Docker Compose 支持，方便開發者快速搭建和測試環境。

已知問題

• 日誌路徑問題：請確保你指定的日誌目錄存在並且有寫權限。
• 環境變量配置：所有環境變量都需要正確填寫，否則會導致連接 PCE 失敗。

總結

Illumio MCP 服務器為用戶提供了一個強大的工具來管理 Illumio 安全策略。通過 Docker 容器化部署，用戶可以方便地在不同環境中使用，並支持與 Claude Desktop 集成。