Davidlin2k Pox MCP Server

🚀 POX MCP Server

A server implementation based on the Model Context Protocol (MCP), providing network control and management functions through the POX SDN controller. This server supports Python-based network programming, OpenFlow device management, and automated network analysis. Thanks to POX's modular architecture, it is well-suited for educational environments, network prototyping, and SDN research.

🚀 Quick Start

✨ Features

• A server implementation based on the Model Context Protocol (MCP), offering network control and management capabilities via the POX SDN controller.
• Supports Python-based network programming, OpenFlow device management, and automated network analysis.
• Ideal for educational settings, network prototyping, and SDN research due to POX's modular architecture.

📦 Components

🔍 Resources

The server exposes two dynamic resources:

• pox://network-config: A comprehensive POX controller configuration record book

  • Tracks active POX components and their configurations.
  • Records network topology and flow rules.
  • Maintains discovered network insights.

• pox://topology: A real-time network topology view

  • Displays active OpenFlow data paths (switches).
  • Maps host locations and connection relationships.
  • Shows link status and port mappings.

💡 Prompts

The server provides three professional prompts:

• pox-network-manager: An interactive prompt for POX controller management

  • Required parameter: topic - Aspects of network control that need attention.
  • Helps configure POX components and modules.
  • Guides the implementation of network policies.
  • Integrates into the network configuration record book.

• simple-hub: A basic L2 switch implemented using POX

  • Required parameter: dpid (Data Path Identifier).
  • Demonstrates POX's event-driven programming mechanism.
  • Shows basic packet processing and flooding operations.
  • Explains POX's core mechanisms.

• learning-switch: An L2 learning switch implementation

  • Required parameter: dpid (Data Path Identifier).
  • Demonstrates POX's table management functionality.
  • Implements MAC address learning and forwarding.
  • Shows POX's packet processing capabilities.

🛠️ Tools

The server provides five core tools:

📋 Data Path Management Tools

• get_switches

  • Lists all connected OpenFlow data paths.
  • No input required.
  • Returns: A list of active POX-controlled switches, including connection status and capabilities.

• get_switch_desc

  • Retrieves detailed data path information.
  • Input:
    • dpid (string): Data Path Identifier.
  • Returns: Details and capabilities of the POX-managed switch.

🔄 Flow Management Tools

• get_flow_stats

  • Retrieves POX flow statistics.
  • Input:
    • dpid (string): Data Path Identifier.
    • match (object, optional): POX match structure.
    • table_id (string, optional): OpenFlow table ID.
    • out_port (string, optional): Output port filter.
  • Returns: POX flow statistics, including packet counts.

• set_table

  • Configures the POX flow table.
  • Input:
    • dpid (string): Data Path Identifier.
    • flows (array): POX flow specifications.
  • Returns: Confirmation of flow table update.

📊 Analysis Tools

• append_insight
  • Adds network insights to the POX configuration record book.
  • Input: [The specific input details were not fully provided in the original text, so it remains as "Input" here.]