ONOS MCP Server

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"
      }
    }
  }
}

参与贡献

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