Openwrt MCP Server

🚀 openwrt-mcp-server

openwrt-mcp-server 是一個輕量級且可擴展的 MCP（模型上下文協議）服務器，專為在基於 OpenWrt 的嵌入式路由器和設備上運行而設計。它通過 MQTT 和 HTTP 實現設備與外部 AI 系統之間的雙向通信，使用 JSON-RPC 2.0 作為消息格式。

此服務器旨在為 AI 代理提供一個安全且結構化的接口，以實現以下功能：

• 查詢即時設備上下文（網絡、Wi-Fi、系統指標）
• 遠程執行系統級命令
• 支持即時命令響應和上下文流式傳輸

✨ 主要特性

• 使用 Rust 編寫，具備高性能和安全性。
• 支持 MQTT（通過 rumqttc）和 HTTP（通過 warp）。
• 與 JSON-RPC 2.0 兼容，便於 AI 模型集成。
• 採用模塊化架構，支持未來擴展。
• 提供完整的 TOML 配置，所有字段均在代碼中實際使用（見下文）。
• 具備安全的 HTTP API，採用基於令牌的身份驗證（通過 x-api-token 標頭）。
• 所有代碼註釋和文檔均為英文編寫，以支持國際協作。
• 編譯無警告（所有配置字段均被使用）。
• 內存佔用低，適合嵌入式 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：加載和驗證完整的 .toml 配置，包括所有 MQTT/HTTP 字段。
• 所有模塊均有英文文檔。

🛡️ 協議

遵循 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 支持
• [ ] 文檔和示例完善