Pox MCP Server

🚀 POX MCP 服務器

POX MCP 服務器是基於 POX SDN 控制器實現的模型上下文協議（MCP）服務器，藉助 POX 的模塊化架構，提供強大的網絡控制和管理功能。用戶可使用 Python 進行網絡編程、管理 OpenFlow 設備以及開展自動化網絡分析。該服務器適用於教育環境、網絡原型設計和 SDN 研究。

🚀 快速開始

與 Claude Desktop 的使用

uv

{
  "mcpServers": {
    "pox": {
      "command": "uv",
      "args": [
        "--directory",
        "parent_of_servers_repo/servers/src/mcp_server_pox",
        "run",
        "server.py"
      ],
      "env": {
        "POX_SERVER_URL": "http://localhost:8000"
      }
    }
  }
}

✨ 主要特性

• 允許使用 Python 進行網絡編程、OpenFlow 設備管理以及自動化的網絡分析。
• 公開動態資源，提供全面的 POX 控制器配置存儲和即時網絡拓撲視圖。
• 提供專用提示，幫助配置 POX 組件和模塊，指導網絡策略實施。
• 提供核心工具，用於 Datapath 管理、Flow 管理和網絡分析。

📚 詳細文檔

組件

資源

該服務器公開兩個動態資源：

• pox://network-config：一個全面的 POX 控制器配置存儲
  • 跟蹤活動 POX 組件及其配置。
  • 記錄網絡拓撲和流規則。
  • 維護髮現的網絡見解。
• pox://topology：即時網絡拓撲視圖
  • 顯示活動 OpenFlow datapath（交換機）。
  • 地圖主機位置和連接。
  • 顯示鏈路狀態和端口映射。

提示

該服務器提供三個專用提示：

• pox-network-manager：用於 POX 控制器管理的交互式提示

  • 必需參數：topic - 網絡控制方面關注的重點。
  • 幫助配置 POX 組件和模塊。
  • 指導網絡策略實施。
  • 整合到網絡配置存儲中。

• simple-hub：使用 POX 實現的基本 L2 中樞

  • 必需參數：dpid - 數據通路標識符。
  • 展示 POX 的事件驅動編程。
  • 顯示基本數據包處理和洪泛。
  • 解釋 POX 的核心機制。

• learning-switch：使用 POX 實現的學習 L2 交換機

  • 必需參數：dpid - 數據通路標識符。
  • 展示 POX 的表管理。
  • 實現 MAC 學習和轉發。
  • 展示 POX 的數據包處理能力。

工具

該服務器提供五個核心工具：

Datapath 管理工具

• get_switches

  • 列出所有連接的 OpenFlow datapath。
  • 無需輸入。
  • 返回：活動 POX 控制交換機數組，包括連接狀態和功能。

• get_switch_desc

  • 獲取詳細 datapath 信息。
  • 輸入：
    • dpid（字符串）：datapath 標識符。
  • 返回：POX 管理的交換機詳細信息和功能。

Flow 管理工具

• get_flow_stats

  • 檢索 POX 流統計信息。
  • 輸入：
    • dpid（字符串）：datapath 標識符。
    • match（對象，可選）：POX 匹配結構。
    • table_id（字符串，可選）：OpenFlow 表 ID。
    • out_port（字符串，可選）：輸出端口過濾。
  • 返回：POX 流統計信息包括數據包計數。

• set_table

  • 配置 POX 流表。
  • 輸入：
    • dpid（字符串）：datapath 標識符。
    • flows（數組）：POX 流規範。
  • 返回：流表更新確認。

分析工具

• append_insight
  • 將網絡見解添加到 POX 配置存儲中。
  • 輸入：
    • insight（字符串）：網絡觀察或分析。
  • 返回：見解添加確認，更新 pox://network-config 資源。

📄 許可證

此 MCP 服務器根據 MIT 許可證分發。這意味著你可以自由使用、修改和分發軟件，但需遵守 MIT 許可證的條款和條件。有關更多詳細信息，請參見項目倉庫中的 LICENSE 文件。

💪 貢獻

歡迎貢獻！請隨時提交拉取請求、報告錯誤或建議新功能。