Onos Mcp Server

ONOS MCP Server

ONOS MCP Server 是 Model Context Protocol（MCP） 与 Open Network Operating System（ONOS） 之间的强大桥梁。它使 AI 模型能够直接与您的 SDN（软件定义网络）基础设施交互，从而实现智能网络管理、监控和自动化。

---

功能特性

• 应用管理：列出、检查、激活和停用 ONOS 应用。
• 设备清单：详细查看交换机、路由器和其他网络实体。
• 主机发现：跟踪终端节点、其位置以及 IP/MAC 关联信息。
• 流量控制：全面查看和控制网络流（列出流、按设备筛选以及添加新流）。
• 无缝集成：基于 Spring Boot 和 Spring AI MCP 构建，性能可靠，可用于生产环境。

---

前置条件

• Java 21 或更高版本。
• Maven 3.9+（或使用随附的 ./mvnw）。
• 正在运行的 ONOS Controller 实例（建议使用 v2.x 或更高版本）。

---

配置

该服务通过 REST API 连接到 ONOS。您可以在 src/main/resources/application.yaml 中配置连接详细信息，也可以通过环境变量配置。

onos:
    controller:
        host: ${ONOS_CONTROLLER_HOST:http://localhost:8181}
        username: ${ONOS_CONTROLLER_USERNAME:onos}
        password: ${ONOS_CONTROLLER_PASSWORD:rocks}

环境变量

变量	描述	默认值
ONOS_CONTROLLER_HOST	ONOS 控制器的 URL	http://localhost:8181
ONOS_CONTROLLER_USERNAME	ONOS 用户（需要 REST 访问权限）	onos
ONOS_CONTROLLER_PASSWORD	ONOS 密码	rocks

---

快速开始

1. 构建项目

./mvnw clean install

2. 运行服务

./mvnw spring-boot:run

---

连接到 MCP 客户端

若要将此服务与 MCP 客户端（例如 Claude Desktop 或 Antigravity）配合使用，请将以下配置添加到您的 mcp_config.json（或等效的配置文件）中：

{
  "mcpServers": {
    "onos-mcp-server": {
      "command": "java",
      "args": [
        "-jar",
        "/path/to/onos-mcp-server.jar"
      ],
      "env": {
        "ONOS_CONTROLLER_HOST": "http://localhost:8181",
        "ONOS_CONTROLLER_USERNAME": "onos",
        "ONOS_CONTROLLER_PASSWORD": "rocks"
      }
    }
  }
}

说明

请先使用 ./mvnw clean install 构建项目，以便在 target/ 目录中生成 JAR 文件。

---

可用的 MCP 工具

该服务向 AI 模型提供多个工具：

应用

• list-applications：列出所有已安装应用及其状态。
• get-application：获取特定应用的详细信息。
• activate-application：按名称激活特定应用。
• deactivate-application：停用特定应用。

设备

• list-devices：获取所有设备（交换机、路由器）的列表。
• get-device：获取特定设备的详细信息。

主机

• list-hosts：列出所有已发现的终端节点主机。
• get-host：获取特定主机的详细信息。

流

• list-flows：列出所有网络流。
• list-device-flows：列出特定设备的流。
• add-flow：向设备推送新的流规则。

---

技术栈

• 核心：Java 21、Spring Boot 3.5.9
• AI/MCP：Spring AI Starter MCP Server
• REST 客户端：Spring Cloud OpenFeign
• 实用工具：Lombok

---

由 ortega-kb 用 ❤️ 创建