P

POX模型上下文协议服务器

@davidlin2k/pox-mcp-server
0 Stars 15 次浏览 davidlin2k 更新于 2026-08-23

一个通过POX SDN控制器提供网络控制和管理功能的模型上下文协议服务器，支持基于Python的网络编程、OpenFlow设备管理和自动化的网络分析。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

该服务需要配置环境变量：POX_SERVER_URL

服务介绍

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

贡献

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

查看源码 项目主页