mcp2mqtt (Mcp2everything)

MCP运维云端

提供方 mcp2everything

运维云端 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaudeCline
查看接入方式

mcp2mqtt是一个将物联网设备接入AI大模型的项目,通过MCP和MQTT协议实现自然语言控制硬件设备,适用于智能家居、工业自动化等场景。

一句话选型结论

按资料字段整理

mcp2mqtt (Mcp2everything) 属于运维云端类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude、Cline,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 371 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

物联网Python本地部署AI控制MQTT协议自然语言处理硬件控制

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
python install.py

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cline,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
mcp2mqtt (Mcp2everything)当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方mcp2everything上游标注的维护方 mcp2everything
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.8 KB
来自项目仓库与上游目录的原文,未做删改

mcp2mqtt: 连接物理世界与AI大模型的桥梁

English | 简体中文

通过自然语言控制硬件,开启物联网新纪元

系统架构

mcp2mqtt 系统架构图

工作流程

mcp2mqtt 工作流程图

项目愿景

mcp2mqtt 是一个将物联网设备接入AI大模型的项目,它通过 Model Context Protocol (MCP) 和 MQTT 协议将物理世界与 AI 大模型无缝连接。最终实现:
- 用自然语言控制你的硬件设备
- AI 实时响应并调整物理参数
- 让你的设备具备理解和执行复杂指令的能力
- 通过MQTT协议实现设备间的互联互通

主要特性

  • 智能MQTT通信
  • 支持MQTT协议的发布/订阅模式
  • 支持多种MQTT服务器(如Mosquitto、EMQ X等)
  • 支持QoS服务质量保证
  • 支持主题过滤和消息路由
  • 实时状态监控和错误处理

  • MCP 协议集成

  • 完整支持 Model Context Protocol
  • 支持资源管理和工具调用
  • 灵活的提示词系统
  • 通过MQTT实现命令的发布与响应

配置说明

MQTT配置```yaml

mqtt:
broker: "localhost" # MQTT服务器地址
port: 1883 # MQTT服务器端口
client_id: "mcp2mqtt_client" # MQTT客户端ID
username: "mqtt_user" # MQTT用户名
password: "mqtt_password" # MQTT密码
keepalive: 60 # 保持连接时间
topics:
command:
publish: "mcp/command" # 发送命令的主题
subscribe: "mcp/response" # 接收响应的主题
status:
publish: "mcp/status" # 发送状态的主题
subscribe: "mcp/control" # 接收控制命令的主题


### 命令配置```yaml
commands:
set_pwm:
command: "CMD_PWM {frequency}"
need_parse: false
data_type: "ascii"
prompts:
- "把PWM调到最大"
- "把PWM调到最小"
mqtt_topic: "mcp/pwm"  # MQTT发布主题
response_topic: "mcp/pwm/response"  # MQTT响应主题

MQTT 命令和响应

命令格式

命令使用简单的文本格式:

  1. PWM 控制:
    - 命令:PWM {值}
    - 示例:
    - PWM 100(最大值)
    - PWM 0(关闭)
    - PWM 50(50%)
    - 响应:CMD PWM {值} OK

  2. LED 控制:
    - 命令:LED {状态}
    - 示例:
    - LED on(打开)
    - LED off(关闭)
    - 响应:CMD LED {状态} OK

  3. 设备信息:
    - 命令:INFO
    - 响应:CMD INFO {设备信息}

错误响应

如果发生错误,响应格式将为:
ERROR: {错误信息}

支持的客户端

mcp2mqtt 支持所有实现了 MCP 协议的客户端,以及支持MQTT协议的物联网设备:

客户端类型 特性支持 说明
Claude Desktop 完整支持 推荐使用,支持所有 MCP 功能
Continue 完整支持 优秀的开发工具集成
Cline 资源+工具 支持多种 AI 提供商
MQTT设备 发布/订阅 支持所有MQTT协议的物联网设备

快速开始

1. 安装

Windows用户

下载 install.py```bash
python install.py

#### macOS用户```bash
# 下载安装脚本
curl -O https://raw.githubusercontent.com/mcp2everything/mcp2mqtt/main/install_macos.py

# 运行安装脚本
python3 install_macos.py

Ubuntu/Raspberry Pi用户```bash

下载安装脚本

curl -O https://raw.githubusercontent.com/mcp2everything/mcp2mqtt/main/install_ubuntu.py

运行安装脚本

python3 install_ubuntu.py


安装脚本会自动完成以下操作:
- 检查系统环境
- 安装必要的依赖
- 创建默认配置文件
- 配置Claude桌面版(如果已安装)

### 手动分步安装依赖```bash
windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
MacOS
curl -LsSf https://astral.sh/uv/install.sh | sh

主要依赖uv工具,所以当python和uv以及Claude或Cline安装好后就可以了。

基本配置

在你的 MCP 客户端(如 Claude Desktop 或 Cline)配置文件中添加以下内容:
注意:如果使用的自动安装那么会自动配置Calude Desktop无需此步。
使用默认配置文件:```json
{
"mcpServers": {
"mcp2mqtt": {
"command": "uvx",
"args": [
"mcp2mqtt"
]
}
}
}

> 注意:修改配置后需要重启Cline或者Claude客户端软件
## 配置说明
### 配置文件位置
复制配置文件(`config.yaml`)可以放在位置:
用户主目录(推荐个人使用)```bash
# Windows系统
C:\Users\用户名\.mcp2mqtt\config.yaml

# macOS系统
/Users/用户名/.mcp2mqtt/config.yaml

# Linux系统
/home/用户名/.mcp2mqtt/config.yaml
  • 适用场景:个人配置
  • 需要创建 .mcp2mqtt 目录:```bash

Windows系统(在命令提示符中)

mkdir "%USERPROFILE%.mcp2mqtt"

macOS/Linux系统

mkdir -p ~/.mcp2mqtt


指定配置文件:
比如指定加载Pico配置文件:Pico_config.yaml```json
{
"mcpServers": {
"mcp2mqtt": {
"command": "uvx",
"args": [
"mcp2mqtt",
"--config",
"Pico"  //指定配置文件名,不需要添加_config.yaml后缀
]
}
}
}

为了能使用多个mqtt,我们可以新增多个mcp2mqtt的服务 指定不同的配置文件名即可。
如果要接入多个设备,如有要连接第二个设备:
指定加载Pico2配置文件:Pico2_config.yaml```json
{
"mcpServers": {
"mcp2mqtt2": {
"command": "uvx",
"args": [
"mcp2mqtt",
"--config",
"Pico2" //指定配置文件名,不需要添加_config.yaml后缀
]
}
}
}


### 硬件连接
1. 将你的设备通过网络连接到mqtt服务器
2. 也可以用tests目录下的responder.py来模拟设备

## 运行测试

### 启动设备模拟器

项目在 `tests` 目录中包含了一个设备模拟器。它可以模拟一个硬件设备,能够:
- 响应 PWM 控制命令
- 提供设备信息
- 控制 LED 状态

启动模拟器:```bash
python tests/responder.py

你应该能看到模拟器正在运行并已连接到 MQTT 服务器的输出信息。

启动客户端Claude 桌面版或Cline

Example in Cline

从源码快速开始

  1. 从源码安装```bash

通过源码安装:

git clone https://github.com/mcp2everything/mcp2mqtt.git
cd mcp2mqtt

创建虚拟环境

uv venv .venv

激活虚拟环境

Windows:

.venv\Scripts\activate

Linux/macOS:

source .venv/bin/activate

安装开发依赖

uv pip install --editable .


### MCP客户端配置
在使用支持MCP协议的客户端(如Claude Desktop或Cline)时,需要在客户端的配置文件中添加以下内容:
直接自动安装的配置方式
源码开发的配置方式
#### 使用默认演示参数:```json
{
"mcpServers": {
"mcp2mqtt": {
"command": "uv",
"args": [
"--directory",
"你的实际路径/mcp2mqtt",  // 例如: "C:/Users/Administrator/Documents/develop/my-mcp-server/mcp2mqtt"
"run",
"mcp2mqtt"
]
}
}
}

指定参数文件名```json

{
"mcpServers": {
"mcp2mqtt": {
"command": "uv",
"args": [
"--directory",
"你的实际路径/mcp2mqtt", // 例如: "C:/Users/Administrator/Documents/develop/my-mcp-server/mcp2mqtt"
"run",
"mcp2mqtt",
"--config", // 可选参数,指定配置文件名
"Pico" // 可选参数,指定配置文件名,不需要添加_config.yaml后缀
]
}
}
}


Example in Cline

### 配置文件位置
配置文件(`config.yaml`)可以放在不同位置,程序会按以下顺序查找:
#### 1. 当前工作目录(适合开发测试)
- 路径:`./config.yaml`
- 示例:如果你在 `C:\Projects` 运行程序,它会查找 `C:\Projects\config.yaml`
- 适用场景:开发和测试
- 不需要特殊权限

#### 2. 用户主目录(推荐个人使用)```bash
# Windows系统
C:\Users\用户名\.mcp2mqtt\config.yaml

# macOS系统
/Users/用户名/.mcp2mqtt/config.yaml

# Linux系统
/home/用户名/.mcp2mqtt/config.yaml
  • 适用场景:个人配置
  • 需要创建 .mcp2mqtt 目录:```bash

Windows系统(在命令提示符中)

mkdir "%USERPROFILE%.mcp2mqtt"

macOS/Linux系统

mkdir -p ~/.mcp2mqtt


#### 3. 系统级配置(适合多用户环境)```bash
# Windows系统(需要管理员权限)
C:\ProgramData\mcp2mqtt\config.yaml

# macOS/Linux系统(需要root权限)
/etc/mcp2mqtt/config.yaml
  • 适用场景:多用户共享配置
  • 创建目录并设置权限:```bash

Windows系统(以管理员身份运行)

mkdir "C:\ProgramData\mcp2mqtt"

macOS/Linux系统(以root身份运行)

sudo mkdir -p /etc/mcp2mqtt
sudo chown root:root /etc/mcp2mqtt
sudo chmod 755 /etc/mcp2mqtt


程序会按照上述顺序查找配置文件,使用找到的第一个有效配置文件。根据你的需求选择合适的位置:
- 开发测试:使用当前目录
- 个人使用:建议使用用户主目录(推荐)
- 多用户环境:使用系统级配置(ProgramData或/etc)

3. 运行服务器:```bash
# 确保已激活虚拟环境
.venv\Scripts\activate

# 运行服务器(使用默认配置config.yaml 案例中用的LOOP_BACK 模拟串口,无需真实串口和串口设备)
uv run src/mcp2mqtt/server.py
或
uv run mcp2mqtt
# 运行服务器(使用指定配置Pico_config.yaml)
uv run src/mcp2mqtt/server.py --config Pico
或
uv run mcp2mqtt --config Pico

文档

  • 安装指南
  • API文档
  • 配置说明

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
mcp2mqtt (Mcp2everything) 怎么安装?

在客户端按下面的安装命令接入:python install.py。装完在客户端配置里引用同一个包或端点。

mcp2mqtt (Mcp2everything) 怎么在 Claude Desktop、Claude、Cline 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

mcp2mqtt (Mcp2everything) 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

mcp2mqtt (Mcp2everything) 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

mcp2mqtt (Mcp2everything) 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cline;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

mcp2mqtt (Mcp2everything) 能提供哪些能力?

资料显示能力标签包括 物联网、AI控制、Python、Claude。具体工具清单以官方文档为准。

mcp2mqtt (Mcp2everything) 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

mcp2mqtt (Mcp2everything) 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。