Alexgoller Illumio MCP Server

🚀 靈光 MCP 服務器

靈光 MCP 服務器是一個提供接口與靈光 PCE（策略計算引擎）交互的模型上下文協議（MCP）服務器。它實現了對靈光工作負載管理、標籤操作和流量分析的編程訪問，為用戶提供了便捷的操作體驗。

🚀 快速開始

要使用靈光 MCP 服務器，您需要滿足以下先決條件：

• Python 3.8+ 版本
• 訪問靈光 PCE 實例
• PCE 的有效 API 憑證

✨ 主要特性

使用對話式 AI 與您的 PCE 互動，具備以下功能：

• 創建、更新和刪除工作負載
• 創建、更新和刪除標籤
• 獲取流量摘要並對其執行安全分析
• 獲取 PCE 健康狀態

📦 安裝指南

1. 克隆倉庫：

git clone [倉庫地址]
cd illumio-mcp

2. 安裝依賴項：

pip install -r requirements.txt

💻 使用示例

基礎用法

建議使用 uv 命令運行，以便更輕鬆地傳遞環境變量並在後臺執行。在不同操作系統下，可按以下方式配置：

• 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"
      }
    }
  }
}

高級用法

啟動服務器的示例命令如下：

uvicorn main:app --reload

啟動服務器後，訪問 http://localhost:8000 即可使用 API。

📚 詳細文檔

功能特性

資源

資源尚未完成，後續將進行研究。

• 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 文件。

通過以上步驟，您可以成功配置和使用靈光 MCP 服務器。如需進一步幫助，請參考官方文檔或聯繫支持團隊。