POX MCP Server

POX MCP Server

Model Context Protocol server for SDN management via the POX controller.

1
Stars
7
Forks
1
Watchers
4
Issues
Implements a Model Context Protocol (MCP) server for network control and management using the POX SDN controller. Provides dynamic resources for network configuration and topology, interactive management prompts, and a suite of tools for switch and flow administration. Supports Python-based SDN programming and automated analysis in educational and research settings.

Key Features

Exposes dynamic resources for network configuration and topology
Interactive management prompts for controller and module configuration
Tools for datapath and flow management
Real-time topology visualization
Resource for storing and updating network insights
Python-based extensibility
Integration with POX modular architecture
Educational and prototyping focus
Automated collection of flow statistics
Support for network policy implementation

Use Cases

Managing and configuring OpenFlow switches in SDN environments
Monitoring and analyzing real-time network topology
Automating flow rule updates and network policy changes
Educational demonstrations of SDN programming concepts
Prototyping and testing new network architectures
Collecting and recording network insights and analysis results
Integrating with AI or automated systems for intelligent network management
Building interactive network management tools for SDN research
Supporting hands-on SDN coursework or tutorials
Facilitating rapid experimentation with POX controller capabilities

README

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

Tools

The server offers five core tools:

Datapath Management Tools

  • get_switches

    • List all connected OpenFlow datapaths
    • No input required
    • Returns: Array of active POX-controlled switches
    • Includes connection status and capabilities
  • get_switch_desc

    • Get detailed datapath information
    • Input:
      • dpid (string): Datapath identifier
    • Returns: POX-managed switch details and features

Flow Management Tools

  • get_flow_stats

    • Retrieve POX flow statistics
    • Input:
      • dpid (string): Datapath 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

    • Configure POX flow tables
    • Input:
      • dpid (string): Datapath identifier
      • flows (array): POX flow specifications
    • Returns: Flow table update confirmation

Analysis Tools

  • append_insight
    • Add network insights to POX configuration memo
    • Input:
      • insight (string): Network observation or analysis
    • Returns: Insight addition confirmation
    • Updates pox://network-config resource

Usage with Claude Desktop

uv

json
{
  "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"
      }
    }
  }
}

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Contributing

Contributions are welcome! Please feel free to submit pull requests, report bugs, or suggest new features.

Star History

Star History Chart

Repository Owner

davidlin2k
davidlin2k

User

Repository Details

Language Python
Default Branch master
Size 30 KB
Contributors 1
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Python
100%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • OPNsense MCP Server

    OPNsense MCP Server

    AI-powered firewall and network management for OPNsense

    OPNsense MCP Server provides a comprehensive Model Context Protocol server for automating and managing OPNsense firewall configurations. It enables AI assistants, such as Claude, to directly interact with and control networking features including firewall rules, NAT, VLANs, diagnostics, and advanced system operations via API and SSH. The tool supports batch operations, direct command execution, and advanced troubleshooting, enhancing network management automation. It also supports integration for infrastructure as code and toolchains supporting MCP environments.

    • 26
    • MCP
    • vespo92/OPNSenseMCP
  • HarmonyOS MCP Server

    HarmonyOS MCP Server

    Enables HarmonyOS device manipulation via the Model Context Protocol.

    HarmonyOS MCP Server provides an MCP-compatible server that allows programmatic control of HarmonyOS devices. It integrates with tools and frameworks such as OpenAI's openai-agents SDK and LangGraph to facilitate LLM-powered automation workflows. The server supports execution through standard interfaces and can be used with agent platforms to process natural language instructions for device actions. Its design allows for seamless interaction with HarmonyOS systems using the Model Context Protocol.

    • 25
    • MCP
    • XixianLiang/HarmonyOS-mcp-server
  • Higress OPS MCP Server

    Higress OPS MCP Server

    Model Context Protocol server and client for fully managed Higress configuration.

    Higress OPS MCP Server delivers a Model Context Protocol-compliant server and client for centralized configuration and management of Higress. It leverages a flexible tool-based architecture and offers seamless integration with LangGraph and LangChain MCP Adapters, streamlining agent-driven workflows for system operations. The package allows developers to define, extend, and register custom tools, supporting secure interaction with the Higress Console API. Sensitive actions can be flagged for human confirmation to enhance operational safety.

    • 22
    • MCP
    • higress-group/higress-ops-mcp-server
  • Flowcore Platform MCP Server

    Flowcore Platform MCP Server

    A standardized MCP server for managing and interacting with Flowcore Platform resources.

    Flowcore Platform MCP Server provides an implementation of the Model Context Protocol (MCP) for seamless interaction and management of Flowcore resources. It enables AI assistants to query and control the Flowcore Platform using a structured API, allowing for enhanced context handling and data access. The server supports easy deployment with npx, npm, or Bun and requires user authentication using Flowcore credentials.

    • 9
    • MCP
    • flowcore-io/mcp-flowcore-platform
  • OPC UA MCP Server

    OPC UA MCP Server

    Bridge AI agents with OPC UA industrial systems in real time.

    OPC UA MCP Server enables seamless integration of AI agents with OPC UA-enabled industrial automation systems. It provides real-time monitoring, analysis, and control of operational data through a set of standardized tool APIs. Supporting both reading and writing of OPC UA nodes, the server facilitates natural language interaction by exposing tools for AI-driven automation and control workflows.

    • 20
    • MCP
    • kukapay/opcua-mcp
  • Zabbix MCP Server

    Zabbix MCP Server

    MCP-compatible Zabbix server integration for comprehensive monitoring and automation.

    Zabbix MCP Server serves as a comprehensive Model Context Protocol (MCP) server, enabling seamless integration with Zabbix using FastMCP and python-zabbix-utils. It offers complete access to Zabbix API functionalities through MCP-compatible tools, supporting advanced management of hosts, groups, items, triggers, templates, and more. The server is designed for easy installation, configuration, and automation of monitoring through a standardized protocol interface.

    • 98
    • MCP
    • mpeirone/zabbix-mcp-server
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results