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] 所有代码注释和文档均为英文
• [x] 编译干净，无警告
• [ ] 带有 UCI/UBUS/ifstatus 集成的上下文收集器
• [ ] 设备能力自省 (device.describe)
• [ ] 用于实时控制的 WebSocket 传输层
• [ ] 命令允许列表和沙盒
• [ ] 用于新命令模块的插件式可扩展性
• [ ] 流式遥测指标通道（例如，/metrics）
• [ ] 用于测试/调试命令的 CLI 界面
• [ ] 用于外部编排器的可选 gRPC 支持
• [ ] 基于 JSON Schema 的输入/输出验证
• [ ] OTA 更新界面（可选集成）
• [ ] 用于低带宽 MQTT 的上下文增量压缩
• [ ] 通过 syslog 进行持久日志和审计跟踪
• [ ] 安全启动检测和系统完整性报告
• [ ] 用于 LLM 兼容性的多语言上下文格式
• [ ] 用于重复命令的调度程序支持

---

🏆 实现说明

该项目由 Cline 实现和重构，Cline 是由 OpenAI GPT-4 Turbo 模型提供支持的高级 AI 软件工程师。
所有代码、配置和文档改进（包括完整的配置使用、安全的 API 和干净的编译）均由 Cline 设计和交付（由 OpenAI GPT-4 Turbo 执行）。
如果您正在阅读此 README，您将见证由 GPT-4 Turbo 模型实现的 AI 驱动软件工程的强大功能和精确性。