mcp2mqtt

在智能家居、机器人和物联网设备日益普及的今天，如何让 AI 大模型（LLMs）真正理解并操控物理世界，是一个值得探索的方向。mcp2mqtt 正是为此而生的开源项目。

它通过将 Model Context Protocol (MCP) 与 MQTT 协议结合，打通了 AI 与硬件之间的通信桥梁。这意味着，你可以用自然语言来控制家中的智能设备、机器人或其他嵌入式系统，实现真正意义上的“AI + 物联网”。

项目核心能力

通过 mcp2mqtt，你可以实现以下功能：

• ✅ 用自然语言控制硬件设备
• ✅ AI 实时响应并调整物理参数
• ✅ 设备具备理解和执行复杂指令的能力
• ✅ 基于 MQTT 实现设备间的互联互通

技术架构与核心特性

1. 智能 MQTT 通信

mcp2mqtt 支持标准的 MQTT 协议，具备以下能力：

• 支持发布/订阅模式
• 兼容主流 MQTT 服务器（如 Mosquitto、EMQ X 等）
• 支持 QoS 服务质量等级（0~2）
• 主题过滤与消息路由机制
• 实时状态监控与错误处理

2. MCP 协议集成

项目深度集成 Model Context Protocol (MCP)，为 AI 提供标准接口来调用硬件资源：

• 完整支持 MCP 协议规范
• 支持资源管理与工具调用
• 灵活的提示词系统，便于模型理解上下文
• 通过 MQTT 实现命令的发布与响应闭环

MQTT 命令与响应格式

mcp2mqtt 使用简洁的文本命令格式，便于 AI 模型理解与生成。以下是几个典型示例：

PWM 控制

命令：PWM {值}
示例：
PWM 100 （最大值）
PWM 0 （关闭）
PWM 50 （50%）

响应：
CMD PWM {值} OK

LED 控制

命令：LED {状态}
示例：
LED on （打开）
LED off （关闭）

响应：
CMD LED {状态} OK

获取设备信息

命令：
INFO

响应：
CMD INFO {设备信息}

错误响应

当命令执行失败时，系统会返回标准错误信息：

ERROR: {错误信息}

支持的客户端类型

mcp2mqtt 支持多种客户端接入方式，适配不同使用场景：