POX MCP 服务器

概述

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

Related MCP server: ONOS MCP Server

成分

资源

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

• pox://network-config ：全面的 POX 控制器配置备忘录

  • 跟踪活动的 POX 组件及其配置

  • 记录网络拓扑和流向规则

  • 维护已发现的网络洞察

• pox://topology ：实时网络拓扑视图

  • 显示活动的 OpenFlow 数据路径（交换机）

  • 地图主机位置和连接

  • 显示链接状态和端口映射

提示

服务器提供了三种专门的提示：

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

  • 必需参数： topic - 要关注的网络控制方面

  • 帮助配置 POX 组件和模块

  • 指导网络政策实施

  • 与网络配置备忘录集成

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

  • 必需参数： 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 （字符串）：网络观察或分析

  • 返回：Insight 添加确认

  • 更新 pox://network-config 资源

与 Claude Desktop 一起使用

紫外线

{
  "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 文件。

贡献

欢迎贡献代码！欢迎提交 Pull 请求、报告 Bug 或建议新功能。