POX MCP Server

Name: POX MCP Server
Author: davidlin2k

@davidlin2k

Repository

About POX MCP Server

A Model Context Protocol (MCP) server for the POX SDN controller

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is POX MCP Server?

POX MCP Server is a Model Context Protocol (MCP) server that integrates with the POX SDN controller, enabling Python-based network programming, OpenFlow device management, and automated network analysis. It is designed for educational environments, network prototyping, and SDN research.

How to use POX MCP Server?

Configure it in Claude Desktop by adding the server to mcpServers using uv with the appropriate directory path and a POX_SERVER_URL environment variable pointing to the POX controller. The server exposes resources, prompts, and tools for network control and analysis.

Key features of POX MCP Server

Dynamic resources: network configuration memo and real-time topology
Three specialized prompts for controller management and switch learning
Tools for datapath and flow management
Insight analysis tool to add observations to configuration
Integrates with POX’s modular, event-driven architecture

Use cases of POX MCP Server

Managing POX controller components and configuring network policies
Demonstrating L2 hub and learning switch behavior in an SDN lab
Retrieving flow statistics and updating flow tables on OpenFlow switches
Collecting and recording network insights for automated analysis
Prototyping SDN applications in educational or research settings

FAQ from POX MCP Server

What is the POX MCP Server used for?

It provides network control and management capabilities through the POX SDN controller, allowing Python-based network programming, OpenFlow device management, and automated network analysis.

How do I configure the POX MCP Server for Claude Desktop?

Use a uv command with the server directory and set the POX_SERVER_URL environment variable, e.g., "POX_SERVER_URL": "http://localhost:8000".

What tools does the POX MCP Server provide?

Five core tools: get_switches, get_switch_desc, get_flow_stats, set_table, and append_insight. They cover datapath listing, descriptor retrieval, flow statistics, table configuration, and insight addition.

What resources are available?

Two dynamic resources: pox://network-config (controller configuration, topology, flow rules, insights) and pox://topology (real‑time network view with switches, hosts, links, and ports).