🚀 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 集成。