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

🤝 貢献

貢献を歓迎します！プルリクエストの提出、エラーの報告、または新機能の提案を自由に行ってください。