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实现自动恢复和自愈网络策略
• 与LLMs和编排管道（如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。

🚀 发展路线图

• 初始MQTT + HTTP双协议支持
• 完整的TOML配置，所有字段在代码中使用
• JSON-RPC 2.0命令和上下文模式（MQTT/HTTP中的分发和响应逻辑）
• 基于令牌身份验证的安全HTTP API
• 所有代码注释和文档均为英文
• 编译无警告
• 集成UCI/UBUS/ifstatus的上下文收集器
• 设备能力内省（device.describe）
• 实时控制的WebSocket传输层
• 命令白名单和沙箱
• 插件式扩展新命令模块
• 流式遥测指标通道（例如，/metrics）
• 测试/调试命令的CLI界面
• 外部编排器的可选gRPC支持
• 基于JSON Schema的输入/输出验证
• 可选集成的OTA更新接口
• 低带宽MQTT的上下文增量压缩
• 通过syslog持久日志和审计跟踪
• 安全启动检测和系统完整性报告
• 多语言上下文格式化，兼容LLMs
• 命令调度支持

---

🏆 实现说明

本项目由Cline实现和重构，Cline是由OpenAI GPT-4 Turbo模型驱动的高级AI软件工程师。 所有代码、配置和文档改进——包括完整的配置使用、安全API和无警告编译——均由Cline设计并交付（由OpenAI GPT-4 Turbo执行）。 如果您正在阅读此README，您正在见证由GPT-4 Turbo模型实现的AI驱动软件工程的力量和精确度。