POX MCP 服务器

概述

一个模型上下文协议 (MCP) 服务器的实现，通过 POX SDN 控制器提供网络控制和管理功能。该服务器支持基于 Python 的网络编程、OpenFlow 设备管理以及通过 POX 的模块化架构实现自动化网络分析。非常适合教育环境、网络原型设计和 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 文件。

贡献

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