Davidlin2k Onos MCP Server

🚀 ONOS MCP 服務器

一個基於 ONOS SDN 控制器實現的模型上下文協議 (MCP) 服務器，藉助 ONOS 的 REST API 提供網絡控制與管理功能，涵蓋 OpenFlow 設備控制和全面分析。此服務器非常適合教育環境、網絡原型設計以及 ONOS 研究。

🚀 快速開始

要求

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

✨ 主要特性

資源

該服務器公開了超過 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/*：端口、流和速率限制器的統計信息
• 其他資源用於設備配置、QoS 管理和其他診斷任務

提示

該服務器提供以下交互式提示：

• 網絡管理：通過特定命令查看和操作網絡拓撲。
• 設備控制：對設備進行配置和監控，如查看端口狀態。
• 流量分析：分析網絡流量並生成報告。
• QoS 管理：配置和服務質量 (QoS) 設置以優化網絡性能。
• 故障排除：診斷網絡問題，收集日誌和錯誤信息。

工具

該服務器提供以下工具：

• 網絡管理工具：用於拓撲分析、路徑計算和設備監控。
• 應用管理工具：用於安裝、升級和卸載應用程序。
• 配置工具：對設備和服務進行詳細配置。
• 診斷工具：用於故障排除和性能優化。

📄 許可證

該 MCP 服務器根據 MIT 許可證發佈。這意味著您可以自由使用、修改和分發軟件，但需遵守 MIT 許可證的條款和條件。有關詳細信息，請參閱項目存儲庫中的 LICENSE 文件。

🤝 貢獻

歡迎貢獻！請隨時提交拉取請求、報告錯誤或建議新功能。