POX SDN Controller

by davidlin2k

1 stars

155 downloads

Not rated

GitHub

About

Bridges to the POX SDN controller, enabling network topology management and configuration of OpenFlow-based networks through specialized tools for datapath management, flow statistics, and table configuration.

Details

Author: davidlin2k
Repository: davidlin2k/pox-mcp-server
GitHub stars: 1
Downloads: 155
License: MIT License
Categories: Developer Tools, Infrastructure, AI, Search, Knowledge Base, Other
Tags: #analytics, #integration

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name POX SDN Controller

Command (node, npx, python, etc.) uv
Arguments
- Argument 1 --directory
- Argument 2 parent_of_servers_repo/servers/src/mcp_server_pox
- Argument 3 run
- Argument 4 server.py
Environment
- POX_SERVER_URL http://localhost:8000
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

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.

`get_switches`

List all connected OpenFlow datapaths. No input required. Returns an array of active POX-controlled switches including connection status and capabilities.

`get_switch_desc`

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

`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.

`append_insight`

Add network insights to POX configuration memo. Input: insight (string) - Network observation or analysis. Returns insight addition confirmation and updates pox://network-config resource.

The server offers five core tools:

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

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

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.

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

- Shows active OpenFlow datapaths (switches)
- Maps host locations and connections
- Displays link status and port mappings

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

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

- Get detailed datapath information
- Input:

- dpid(string): Datapath identifier

- 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

- Configure POX flow tables
- Input:

- dpid(string): Datapath identifier
- flows(array): POX flow specifications

- append_insight

- Add network insights to POX configuration memo
- Input:

- insight(string): Network observation or analysis

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

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.

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

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Production-ready MCP server for AI-driven console automation and monitoring. 40+ tools for session management, SSH, testing, and background jobs.

Hetzner Cloud MCP Server — (Cloud API + SSH)

Hetzner Cloud MCP Server — two management layers (Cloud API + SSH) with 60 tools. Manage server power, snapshots, firewalls, DNS, plus SSH into servers for service control, log viewing, Nginx management, MySQL queries, and system monitoring. Self-hosted PHP, MIT licensed.

Provides remote machine control capabilities, eliminating SSH overhead for token-efficient system operations.

Orchestrates remote server tasks via SSH and SFTP with a persistent queue. Ideal for DevOps and AI agents.

Securely execute remote commands and perform file operations over SSH, with support for both password and key-based authentication.

MCP server that exposes an SSH server list from a TOML config file

MCP-based SSH session manager for Linux backend teams

Execute commands on local or remote hosts via SSH. Supports session persistence and environment variables.

MCP access to cluster-wide L4 and L7 network traffic, packets, APIs, and complete payloads.

Proxyman MCP allows AI to inspect HTTP traffic, create debugging rules, and control Proxyman - all through natural language conversations.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

POX SDN Controller

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

`get_switches`

`get_switch_desc`

`get_flow_stats`

`set_table`

`append_insight`

Claude Desktop / Cursor

Linux

Macos

Windows

Hetzner Cloud MCP Server — (Cloud API + SSH)

Install

About

Details

Jump to

Setting up with Highlight

From the repository

get_switches

get_switch_desc

get_flow_stats

set_table

append_insight

Claude Desktop / Cursor

Linux

Macos

Windows

Hetzner Cloud MCP Server — (Cloud API + SSH)

Install

More like this

Sentry

Github

Git

GitLab

Context 7

1Panel

`get_switches`

`get_switch_desc`

`get_flow_stats`

`set_table`

`append_insight`