JinDaGe - onos-mcp-server MCP Details

article

README

🚀 ONOS MCP 服务器

这是一个基于模型上下文协议（MCP）的服务器实现，借助 ONOS SDN 控制器，为用户提供强大的网络控制和管理功能。通过结构化的 API 接口，人工智能助手能够轻松访问 ONOS 网络管理、OpenFlow 设备控制以及各类全面的分析工具。该服务器广泛适用于教育环境、网络运维、SDN 研究和 AI 辅助网络管理等场景。

🚀 快速开始

配置要求

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

✨ 主要特性

网络资源

服务器提供对 ONOS REST API 端点的访问，涵盖以下方面：

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

分析工具

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

专用提示

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

📄 许可证

文档中未提及相关许可证信息。

🤝 贡献

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

onos-mcp-server