POX MCP Server

POX MCP 服务

概述

一种模型上下文协议（MCP）服务实现，通过 POX SDN 控制器提供网络控制和管理功能。该服务借助 POX 的模块化架构，支持基于 Python 的网络编程、OpenFlow 设备管理和自动化网络分析。非常适合教育环境、网络原型开发和 SDN 研究。

组件

资源

该服务公开两个动态资源：

• pox://network-config：全面的 POX 控制器配置备忘录
  • 跟踪活动的 POX 组件及其配置
  • 记录网络拓扑和流规则
  • 维护已发现的网络洞察
• pox://topology：实时网络拓扑视图
  • 显示活动的 OpenFlow 数据路径（交换机）
  • 映射主机位置和连接
  • 显示链路状态和端口映射

提示词

该服务提供三个专用提示词：

• pox-network-manager：用于管理 POX 控制器的交互式提示词

  • 必需参数：topic —— 要重点关注的网络控制方面
  • 帮助配置 POX 组件和模块
  • 指导实施网络策略
  • 与网络配置备忘录集成

• simple-hub：使用 POX 实现的基本 L2 集线器

  • 必需参数：dpid —— 数据路径标识符
  • 演示 POX 的事件驱动编程
  • 展示基本的数据包处理和泛洪
  • 解释 POX 的核心机制

• learning-switch：L2 学习型交换机实现

  • 必需参数：dpid —— 数据路径标识符
  • 展示 POX 的表管理功能
  • 实现 MAC 学习和转发
  • 演示 POX 的数据包处理能力

工具

该服务提供五种核心工具：

数据路径管理工具

• get_switches

  • 列出所有已连接的 OpenFlow 数据路径
  • 无需输入
  • 返回：由 POX 控制的活动交换机数组
  • 包含连接状态和功能

• get_switch_desc

  • 获取详细的数据路径信息
  • 输入：
    • dpid（字符串）：数据路径标识符
  • 返回：由 POX 管理的交换机详情和功能

流管理工具

• get_flow_stats

  • 检索 POX 流统计信息
  • 输入：
    • dpid（字符串）：数据路径标识符
    • match（对象，可选）：POX 匹配结构
    • table_id（字符串，可选）：OpenFlow 表 ID
    • out_port（字符串，可选）：输出端口筛选条件
  • 返回：POX 流统计信息，包括数据包计数

• set_table

  • 配置 POX 流表
  • 输入：
    • dpid（字符串）：数据路径标识符
    • flows（数组）：POX 流规格
  • 返回：流表更新确认

分析工具

• append_insight
  • 将网络洞察添加到 POX 配置备忘录
  • 输入：
    • insight（字符串）：网络观察或分析
  • 返回：洞察添加确认
  • 更新 pox://network-config 资源

在 Claude Desktop 中使用

uv

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

许可证

该 MCP 服务采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。

贡献

欢迎贡献！您可以提交拉取请求、报告错误或建议新功能。