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 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 或建议新功能。

-
security - not tested
A
license - permissive license
-
quality - not tested

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

  1. Overview
    1. Components
      1. Resources
      2. Prompts
      3. Tools
    2. Usage with Claude Desktop
      1. uv
    3. License
      1. Contributing
        ID: ymm8gqe6us