davidlin2k/pox-mcp-server

POX MCP Server

Overview

A Model Context Protocol (MCP) server implementation that provides network control and management capabilities through the POX SDN controller. This server enables Python-based network programming, OpenFlow device management, and automated network analysis through POX's modular architecture. Perfect for educational environments, network prototyping, and SDN research.

Components

Resources

The server exposes two dynamic resources:

• pox://network-config: A comprehensive POX controller configuration memo
  • Tracks active POX components and their configurations
  • Records network topology and flow rules
  • Maintains discovered network insights
• pox://topology: Real-time network topology view
  • Shows active OpenFlow datapaths (switches)
  • Maps host locations and connections
  • Displays link status and port mappings

Prompts

The server provides three specialized prompts:

• pox-network-manager: Interactive prompt for POX controller management

  • Required argument: topic - The network control aspect to focus on
  • Helps configure POX components and modules
  • Guides through network policy implementation
  • Integrates with network configuration memo

• simple-hub: Basic L2 hub implementation using POX

  • Required argument: dpid - The datapath identifier
  • Demonstrates POX's event-driven programming
  • Shows basic packet handling and flooding
  • Explains POX's core mechanisms

• learning-switch: L2 learning switch implementation

  • Required argument: dpid - The datapath identifier
  • Showcases POX's table management
  • Implements MAC learning and forwarding
  • Demonstrates POX's packet handling capabilities