MCP 服务器

ONOS MCP Server

一个模型上下文协议服务器，它通过 ONOS 的 REST API 提供对 ONOS SDN 控制器网络管理功能的编程访问，从而实现设备控制、拓扑管理和分析。

README

ONOS MCP 服务器

概述

一个模型上下文协议 (MCP) 服务器实现，通过 ONOS SDN 控制器提供网络控制和管理功能。该服务器通过 ONOS 的 REST API 实现对 ONOS 网络管理、OpenFlow 设备控制和全面分析的程序化访问。非常适合教育环境、网络原型设计以及使用 ONOS 的 SDN 研究。

组件

资源

该服务器公开了 30 多个动态资源，包括：

onos://devices: 关于所有网络设备的信息
onos://device/{deviceId}: 关于特定设备的详细信息
onos://links: 关于所有网络链路的信息
onos://hosts: 关于连接到网络的所有主机的信息
onos://topology: 当前网络拓扑的概述
onos://applications: 关于所有已安装应用程序的信息
onos://flows/{deviceId}: 特定设备的所有流条目
onos://system: 高级系统信息、版本和内存使用情况
onos://metrics: 所有指标的统计信息
onos://meters/{deviceId}: 特定设备的所有计量器条目
onos://intents: 系统中的所有意图
onos://statistics/*: 端口、流和表的各种统计资源
onos://network/configuration: 整个网络配置
onos://configuration: 组件配置
还有更多用于全面访问 ONOS 系统

提示

该服务器提供九个专门的提示：

diagnose-network-issue: 用于诊断网络问题的交互式提示
- 帮助识别连接问题和服务降级
- 分析网络症状和变化
- 建议有针对性的解决方案
design-network-flow: 协助设计和实施网络流
- 帮助创建流量隔离、负载平衡和安全策略
- 指导源/目标流的创建
- 支持特定的路由要求
configure-intent-based-networking: 支持基于意图的网络
- 指导连接目标实施
- 帮助进行流量优先级排序
- 协助进行弹性和故障转移配置
network-health-report: 全面的网络状态分析
- 提供设备可用性报告
- 提供流和意图统计信息
- 识别瓶颈和性能问题
sdn-migration-planning: 使用 ONOS 进行 SDN 迁移的规划
- 帮助评估当前架构
- 指导完成迁移目标和优先级
- 制定分阶段实施策略
system-health-check: ONOS 的系统级诊断
- 分析资源利用率
- 报告集群状态
- 评估组件健康状况
metrics-analysis: 对 ONOS 指标的深入分析
- 识别性能瓶颈
- 突出显示异常
- 推荐优化
qos-configuration: 服务质量实施指南
- 帮助确定流量类型优先级
- 协助提供带宽和延迟保证
- 创建基于类的服务级别
performance-tuning: ONOS 部署的优化
- 解决性能问题
- 增强资源分配
- 改进架构以实现扩展

工具

该服务器提供 20 多个强大的工具，包括：

网络管理工具

get_network_summary
- 获取网络的高级摘要，包括设备、链路和主机
- 无需输入
- 返回包含设备详细信息的全面网络概述
get_network_analytics
- 获取有关网络性能、利用率和健康状况的分析
- 无需输入
- 返回详细的性能指标和利用率统计信息
get_system_health
- 获取全面的系统健康信息，包括内存使用情况和集群状态
- 无需输入
- 返回包含内存利用率和节点状态的详细健康报告

应用程序管理工具

install_application
- 从 OAR 文件 URL 安装新的 ONOS 应用程序
- 输入：app_file_url (字符串)
- 返回安装状态
activate_application
- 激活 ONOS 应用程序
- 输入：app_name (字符串)
- 返回激活状态
deactivate_application
- 停用 ONOS 应用程序
- 输入：app_name (字符串)
- 返回停用状态
remove_application
- 卸载 ONOS 应用程序
- 输入：app_name (字符串)
- 返回删除状态

网络配置工具

add_flow
- 向设备添加流规则
- 输入：设备 ID、优先级、超时等
- 返回流添加状态
remove_flow
- 从设备中删除流规则
- 输入：设备 ID 和流 ID
- 返回删除状态
add_intent
- 添加主机到主机的意图
- 输入：应用程序 ID、优先级、源和目标主机
- 返回意图创建状态
get_shortest_path
- 查找两个设备或主机之间的最短路径
- 输入：源和目标 ID
- 返回详细的路径信息

其他工具

用于设备配置、QoS 管理、诊断等的其他工具。

与 Claude Desktop 一起使用

# 将服务器添加到您的 claude_desktop_config.json
{
  "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"
      }
    }
  }
}