Davidlin2k Onos MCP Server

🚀 ONOS MCP サーバ

ONOS SDN コントローラをベースに実装されたモデルコンテキストプロトコル (MCP) サーバです。ONOS の REST API を通じて、OpenFlow デバイスの制御や包括的な分析を含むネットワーク制御と管理機能を提供します。このサーバは、教育環境、ネットワークプロトタイピング、ONOS の研究に最適です。

✨ 主要特性

📦 コンポーネント

🔍 リソース

このサーバは 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) 設定を構成してネットワーク性能を最適化します。
• トラブルシューティング：ネットワーク問題を診断し、ログとエラー情報を収集します。

🛠️ ツール

このサーバは以下のツールを提供します。

• ネットワーク管理ツール：トポロジ分析、パス計算、デバイス監視に使用します。
• アプリケーション管理ツール：アプリケーションのインストール、アップグレード、アンインストールに使用します。
• 構成ツール：デバイスとサービスの詳細構成に使用します。
• 診断ツール：トラブルシューティングとパフォーマンス最適化に使用します。

💻 使用例

基本的な使用法

# サーバをあなたの 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"
      }
    }
  }
}

📚 詳細ドキュメント

要件

• 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）

📄 ライセンス

この MCP サーバは MIT ライセンスの下で公開されています。これは、あなたが自由にソフトウェアを使用、変更、配布できることを意味しますが、MIT ライセンスの条項と条件に従う必要があります。詳細については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。

🔗 貢献

貢献を歓迎します！プルリクエストの提出、エラーの報告、新機能の提案はいつでも歓迎します。