Pox MCP Server

🚀 POX MCP サーバー

POX SDNコントローラをベースに実装されたモデルコンテキストプロトコル（MCP）サーバーです。このサーバーは、ネットワーク制御と管理機能を通じて、ネットワーク制御能力を提供します。POXのモジュール化アーキテクチャのおかげで、Pythonを使ったネットワークプログラミング、OpenFlowデバイス管理、自動化されたネットワーク分析が可能です。教育環境、ネットワークプロトタイピング、SDN研究に最適です。

🚀 クイックスタート

このPOX MCPサーバーを使うことで、Pythonを用いたネットワーク制御やOpenFlowデバイス管理が可能になります。以下に、Claude Desktopとの連携例を示します。

{
  "mcpServers": {
    "pox": {
      "command": "uv",
      "args": [
        "--directory",
        "parent_of_servers_repo/servers/src/mcp_server_pox",
        "run",
        "server.py"
      ],
      "env": {
        "POX_SERVER_URL": "http://localhost:8000"
      }
    }
  }
}

✨ 主な機能

• POXのモジュール化アーキテクチャを利用したPythonによるネットワークプログラミング
• OpenFlowデバイスの管理
• 自動化されたネットワーク分析
• 教育環境、ネットワークプロトタイピング、SDN研究に適した設計

📦 インストール

インストールに関する具体的な手順は原ドキュメントに記載されていません。

💻 使用例

基本的な使用法

Claude Desktopとの連携例は以下の通りです。

{
  "mcpServers": {
    "pox": {
      "command": "uv",
      "args": [
        "--directory",
        "parent_of_servers_repo/servers/src/mcp_server_pox",
        "run",
        "server.py"
      ],
      "env": {
        "POX_SERVER_URL": "http://localhost:8000"
      }
    }
  }
}

📚 ドキュメント

コンポーネント

リソース

このサーバーは2つの動的リソースを公開しています。

• pox://network-config：包括的なPOXコントローラの設定を保存する場所
  • アクティブなPOXコンポーネントとその設定を追跡
  • ネットワークトポロジとフロールールを記録
  • 発見されたネットワークの洞察を維持
• pox://topology：リアルタイムのネットワークトポロジビュー
  • アクティブなOpenFlowデータパス（スイッチ）を表示
  • ホストの位置と接続をマッピング
  • リンクの状態とポートマッピングを表示

ヒント

このサーバーは3つの専用ヒントを提供しています。

• pox-network-manager：POXコントローラ管理のための対話型ヒント
  • 必須パラメータ：topic - ネットワーク制御の重点的な側面
  • POXコンポーネントとモジュールの設定を支援
  • ネットワークポリシーの実施をガイド
  • ネットワーク設定ストレージに統合
• simple-hub：POXを使って実装された基本的なL2ハブ
  • 必須パラメータ：dpid - データパス識別子
  • POXのイベント駆動型プログラミングを示す
  • 基本的なパケット処理とフラッディングを表示
  • POXの核心的なメカニズムを説明
• learning-switch：POXを使って実装された学習型L2スイッチ
  • 必須パラメータ：dpid - データパス識別子
  • POXのテーブル管理を示す
  • MAC学習と転送を実装
  • POXのパケット処理能力を示す

ツール

このサーバーは5つの核心的なツールを提供しています。

Datapath管理ツール

• get_switches
  • 接続されているすべてのOpenFlowデータパスをリストする
  • 入力不要
  • 返り値：アクティブなPOX制御スイッチの配列
  • 接続状態と機能を含む
• get_switch_desc
  • 詳細なデータパス情報を取得する
  • 入力：
    • dpid（文字列）：データパス識別子
  • 返り値：POXが管理するスイッチの詳細情報と機能

Flow管理ツール

• get_flow_stats
  • POXのフロー統計情報を取得する
  • 入力：
    • dpid（文字列）：データパス識別子
    • match（オブジェクト、オプション）：POXのマッチ構造
    • table_id（文字列、オプション）：OpenFlowテーブルID
    • out_port（文字列、オプション）：出力ポートフィルタ
  • 返り値：パケットカウントを含むPOXのフロー統計情報
• set_table
  • POXのフローテーブルを設定する
  • 入力：
    • dpid（文字列）：データパス識別子
    • flows（配列）：POXのフロー仕様
  • 返り値：フローテーブルの更新確認

分析ツール

• append_insight
  • ネットワークの洞察をPOXの設定ストレージに追加する
  • 入力：
    • insight（文字列）：ネットワークの観察または分析
  • 返り値：洞察の追加確認
  • pox://network-configリソースを更新する

📄 ライセンス

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

🔧 技術詳細

原ドキュメントに具体的な技術詳細は記載されていません。

🔗 貢献

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