ONOS MCP 服务器

概述

这是一个模型上下文协议（MCP）服务器实现，通过ONOS SDN控制器提供网络控制和管理功能。该服务器使AI助手能够通过结构化的API接口访问ONOS网络管理、OpenFlow设备控制以及全面的分析功能。该服务器非常适合教育环境、网络运营、SDN研究以及AI辅助的网络管理。

功能

网络资源

服务器提供了对ONOS REST API端点的访问，包括：

• 网络设备、链路和主机
• 拓扑信息
• 流规则和意图
• 应用程序和服务
• 统计数据和指标
• 系统和集群健康状况

分析工具

• 网络概览：获取设备、链路、主机和集群的全面概述，并附有详细的设备信息
• 网络分析：分析性能指标、流量模式和利用率统计
• 系统健康监测：监控内存使用情况、集群状态和组件健康状况
• 应用程序管理：安装、激活、停用和卸载ONOS应用程序
• 流配置：创建和管理流规则和意图
• 路径计算：在网络端点之间找到最优路径

专门提示

• 网络诊断：排查连接问题和服务退化
• 基于意图的配置：实施连接目标和策略
• 网络健康分析：生成全面的状态报告
• QoS配置：设置流量优先级和服务级别
• 性能优化：改进资源分配和可扩展性

要求

• Python 3.7+
• uv 用于依赖项管理
• 运行中的ONOS控制器
• httpx库
• mcp库

配置

使用环境变量配置服务器：

• ONOS_API_BASE：ONOS API的基础URL（默认：http://localhost:8181/onos/v1）
• ONOS_USERNAME：ONOS API认证用户名（默认：onos）
• ONOS_PASSWORD：ONOS API认证密码（默认：rocks）

与Claude Desktop一起使用

{
  "mcpServers": {
    "onos": {
      "command": "uv",
      "args": [
        "--directory",
        "parent_of_servers_repo/servers/src/onos-mcp-server",
        "run",
        "server.py"
      ],
      "env": {
        "ONOS_API_BASE": "http://localhost:8181/onos/v1",
        "ONOS_USERNAME": "onos",
        "ONOS_PASSWORD": "rocks"
      }
    }
  }
}

贡献

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