Network Devices Mcp Sse Server

🖥️ AMXNet - ネットワークデバイス MCP サーバー

aimiox AMXNet ネットワークデバイス MCP サーバーを使用すると、OpenAI Agents SDK または SSE 互換の MCP クライアントを通じて、ネットワークデバイスとシームレスにやり取りできます。サーバー、ルーター、スイッチなど、接続されたデバイスを管理、監視、制御するための強力なインターフェースを提供します。

📋 目次

• 機能
• アーキテクチャ
• インストール
  • Docker
  • 手動インストール
• 設定
• デバイスクライアント
• CLI によるテスト
• プレミアム機能
• 使用例
• サポート

✨ 機能

📡 デバイス管理：リモートデバイスの登録、監視、制御

🔍 ファイル操作：接続されたデバイス上のファイルの一覧表示、読み取り、書き込み、検索

📊 システム監視：システム情報、プロセス、リソース使用状況の表示

🔄 コマンド実行：リモートデバイスでシェルコマンドを実行（プレミアム版では適切な権限が必要です）

🌐 クロスプラットフォーム対応：Linux、OpenWRT、OpenBSD* デバイスで動作

🔒 安全な通信：TLS 暗号化によるデバイス接続

🤖 OpenAI Agent SDK との互換性：AI エージェントと簡単に連携

🏗️ アーキテクチャ

AMXNet は、次の 2 つの主要コンポーネントで構成されています。

1. AMXNet MCP サーバー：次の間の通信を処理する中央サーバーです。

   • デバイスクライアント（ポート 8765 の WebSocket 経由）
   • MCP ホスト／AI エージェント（ポート 8002 の SSE 経由）

2. AMXNet デバイスクライアント：ネットワークデバイス上で動作する軽量な C クライアントです。

   • 複数のアーキテクチャに対応（x86_64、ARM、MIPS）
   • 高い移植性を実現するため、ライブラリへの依存関係はありません
   • リソースの使用量は最小限です

🚀 インストール

Docker を使用（推奨）

AMXNet を実行する最も簡単な方法は、Docker イメージを使用することです。

# Pull the latest image
docker pull aimiox/amxnet-mcp:latest

# Run the server
sudo ./run_amxnet_mcp.sh

または、Docker を手動で使用します。

sudo docker run -d --rm \
  -p 8765:8765 \
  -p 8002:8002 \
  -e AMXNET_DEVICE_PORT=8765 \
  -e AMXNET_SSE_PORT=8002 \
  --name amxnet-mcp \
  aimiox/amxnet-mcp:latest

⚙️ 設定

AMXNet は環境変数を使用して設定できます。

環境変数	デフォルト	説明
AMXNET_DEVICE_PORT	8765	デバイス用の WebSocket ポート
AMXNET_SSE_PORT	8002	MCP ホスト／AI 用の SSE ポート

📱 デバイスクライアント

AMXNet デバイスクライアントは、ネットワークデバイス上で動作し、AMXNet MCP サーバーに接続する軽量なアプリケーションです。

対応アーキテクチャ

複数のアーキテクチャ向けに、ビルド済みバイナリを提供しています。

• x86_64（64 ビット）：標準的な Linux サーバーおよびデスクトップ向け
• ARM（32 ビット）：OpenWRT ルーター、Raspberry Pi、その他の ARM デバイス向け
• MIPS：古い OpenWRT ルーターおよび組み込みデバイス向け

デバイスへのインストール

1. デバイスのアーキテクチャに適したバイナリをダウンロードします
2. 実行可能にします：chmod +x amxnet_device_client_<ARCH>
3. サーバーアドレスを指定して実行します：./amxnet_device_client_<ARCH> --name <device_name> --server <server_ip> --port <server_port>

💎 プレミアム機能

無料版では2 台のデバイスをサポートしています。有料版では、次の機能が追加されます。

• 100 台以上のデバイス：100 台以上のデバイスを接続して管理
• コマンド実行：デバイス上のファイルを変更し、コマンドを実行
• カスタム連携：既存のシステムとの連携
• 優先サポート：エンジニアリングチームに直接アクセス

🧪 CLI クライアントでテスト

OpenAI Agents SDK を使用して SNMP MCP サーバーをテストするには、付属の cli.py を使用します。

1. API キーを設定

プロジェクトのルートに .env ファイルを作成し、次を追加します。

OPENAI_API_KEY=your-openai-key-here

2. MCP エンドポイントを設定

amxnet_cli.py の次の行を編集します。

MCP_AMXNET_URL = "http://<mcp_ip_address>:<mcp_port>/sse"

<mcp_ip_address> と <mcp_port> を、実際のサーバーの値に置き換えます。

3. クライアントを実行

pip install openai-agents
python3 amxnet_cli.py

4. エージェントと対話する

クライアントが SSE サーバーに接続し、AMXNet Network Devices MCP とチャットできるようになります。

🤖 応答例（GPT-4.1-mini 経由）

ユーザープロンプト：

💻 あなた：ネットワークデバイスについて、どのようなサポートができますか？

AI の応答：

🤖 アシスタント： ネットワークデバイスに関するさまざまなタスクをお手伝いできます。たとえば、次のようなタスクです。

1. すべてのネットワークデバイスとその状態を一覧表示する。
2. 特定のデバイスの詳細情報を取得する。
3. デバイスのシステム情報、負荷、ネットワークデータを確認する。
4. デバイス上のファイルを一覧表示し、内容を読み取る。
5. デバイス上のファイルを検索、コピー、比較、作成する。
6. デバイス上で実行中のプロセスを監視する。
7. 必要な権限がある場合、デバイス上でシェルコマンドを実行する。
8. デバイスリストを更新して、最新の状態を取得する。

ネットワークデバイスについて、必要なサポートをお知らせください。

📞 サポート

質問、問題、または貢献については、github.com/aimiox/mcp で issue を作成するか、メールでお問い合わせください。