Openwrt MCP Server

🚀 openwrt-mcp-server

openwrt-mcp-server は、OpenWrt ベースの組み込みルーターやデバイス上で動作するように設計された、軽量で拡張可能な MCP（モデルコンテキストプロトコル）サーバーです。MQTT と HTTP を通じて、デバイスと外部の AI システム間の双方向通信を実現し、JSON - RPC 2.0 をメッセージ形式として使用します。

このサーバーは、AI エージェントに対して安全で構造化されたインターフェースを提供することを目的としています。

• リアルタイムのデバイスコンテキスト（ネットワーク、Wi - Fi、システム指標）を照会する
• システムレベルのコマンドをリモートで実行する
• リアルタイムのコマンド応答とコンテキストのストリーミングをサポートする

✨ 主な機能

• 高性能と安全性を実現するために Rust で記述されています
• MQTT（rumqttc を通じて）と HTTP（warp を通じて）をサポートします
• AI モデルの統合に使用する JSON - RPC 2.0 と互換性があります
• 将来の拡張をサポートするためのモジュール化されたアーキテクチャです
• すべてのフィールドがコード内で実際に使用される完全な TOML 設定があります（下記参照）
• トークンベースの認証（x - api - token ヘッダーを通じて）付きの安全な HTTP API です
• 国際的な協力をサポートするために、すべてのコードコメントとドキュメントは英語で記述されています
• 警告なくクリーンにコンパイルされます（すべての設定フィールドが使用されます）
• 組み込み OpenWrt ターゲットに適した低メモリ消費です

🌎 使用シーン

• AI 駆動の家庭用ゲートウェイの監視とオーケストレーション
• エッジ管理のデバイスフリートのコンテキストレポート
• AI による自動復旧と自己修復ネットワークポリシー
• LLM とオーケストレーションパイプライン（例：n8n、LangChain）との統合

🛠️ コンポーネント

• context/collector.rs：OpenWrt から実行時の状態（ubus、uci、ifstatus）を収集します
• mqtt/handler.rs：MQTT 接続、認証、トピックのサブスクリプションを処理し（すべての設定フィールドを使用）、JSON - RPC コマンドをスケジュール/応答します
• http/routes.rs：状態とコマンド入力用の RESTful API で、すべてのエンドポイントはトークンベースの認証が必要です
• executor/command.rs：検証済みのシステムレベルの命令を実行します
• config/mod.rs：すべての MQTT/HTTP フィールドを含む完全な .toml 設定をロードして検証します
• すべてのモジュールのドキュメントは英語で記述されています

🛡️ プロトコル

JSON - RPC 2.0 に準拠しています。完全なメッセージパターンについては、REQUIREMENTS.md を参照してください。

🔧 ビルド

cargo build --release

デプロイには OpenWrt（musl）のクロスコンパイルが推奨されます。

🌐 設定

サンプルの config.toml（すべてのフィールドが必要で使用されます）：

[mqtt]
broker = "mqtts://iot.example.com:8883"
client_id = "openwrt-one"
username = "mcp-user"
password = "mcp-pass"
topic_prefix = "mcp/device/openwrt-one"

[http]
enable = true
listen_addr = "0.0.0.0"
port = 8080
token = "your-api-token"

• すべての設定フィールドはコードベースでロードされ使用されます。
• MQTT は client_id、username、password、topic_prefix を使用して接続とトピック管理を行います。
• HTTP サーバーは enable、listen_addr、port、token を使用して安全な API アクセスを実現します。

🚀 ロードマップ

• [x] 初期の MQTT + HTTP 双方向プロトコルサポート
• [x] すべてのフィールドがコード内で使用される完全な TOML 設定
• [x] JSON - RPC 2.0 コマンドとコンテキストパターン（MQTT/HTTP 内のスケジュールと応答ロジック）
• [x] トークンベースの認証付きの安全な HTTP API
• [x] すべてのコードコメントとドキュメントは英語で記述されています
• [ ] コンテキスト収集器と UCI/UBUS/ifstatus の統合
• [ ] デバイス機能のイントロスペクション（device.describe）
• [ ] リアルタイム制御のための WebSocket 伝送層
• [ ] コマンド許可リストとサンドボックス化
• [ ] 新しいコマンドモジュールをサポートするプラグイン式拡張性
• [ ] ストリームデータテレメトリ指標チャネル（例：/metrics）
• [ ] テスト/デバッグコマンド用の CLI インターフェース
• [ ] オプションの gRPC サポート
• [ ] ドキュメントとサンプルの充実