[{"_1":2,"_306":-5,"_307":-5},"loaderData",{"_3":4,"_48":49,"_50":51,"_239":240},"root",{"_5":6,"_44":45,"_46":47},"appGlobal",{"_7":8,"_33":34,"_35":36},"config",{"_9":10,"_11":12,"_13":14,"_15":16,"_17":18,"_19":20,"_21":22,"_23":24,"_25":26,"_27":28,"_29":26,"_30":26,"_31":32},"APP_URL","https://glama.ai","ENVIRONMENT","LIVE","FACEBOOK_PIXEL_ID","1988603181578092","GOOGLE_ANALYTICS_MEASUREMENT_ID","G-GDQ5NW5CB5","GOOGLE_OAUTH2_CLIENT_ID","48173796263-7ohlqirg28gh2a7nel61coff3m1ogjtc.apps.googleusercontent.com","POSTHOG_API_KEY","phc_aK0RnJxBEBRE0h0LIz21yyc9w6ylBxwUHMPB4712Bjc","REDDIT_PIXEL_ID","a2_fcqsoymvje51","RELEASE_VERSION","glama@production","SENTRY_DRY_RUN",false,"SENTRY_DSN","https://fc82aa9f808b13927ff29c56bda4d486@o4507975513735168.ingest.us.sentry.io/4507975514849280","SENTRY_SPOTLIGHT","SENTRY_TRACE","STRIPE_PUBLIC_KEY","pk_live_51PcA5zEJhAFNfMYzXX3IOGDiJ5Gw1HYxi328mXMpakKXLgInHaAIDb92FCW35Zx0w0dGMlvXsKCQZ9xKXFSzMICv00ZDL4OZ9M","viewportWidth",1280,"visitorSession",{"_37":38,"_40":-5,"_41":42,"_43":-5},"attributes",[39],"BOT","membership","uid","z0mopxvy0h","userAccount","nonce","279ed7e5f668f3fbfcc94cfcf37c283d","toasts",[],"routes/_public/_layout",{},"routes/_public/mcp/servers/~uid/_pages/_layout",{"_52":-5,"_53":54,"_158":159},"githubUser","mcpServer",{"_55":56,"_57":58,"_37":65,"_68":69,"_70":69,"_71":72,"_77":78,"_94":95,"_96":97,"_90":98,"_99":-5,"_100":-5,"_101":102,"_108":-5,"_109":110,"_115":-5,"_116":117,"_121":122,"_41":155,"_156":157},"addedAt",["D",1735550975887],"argumentsJsonSchema",{"_59":60,"_61":62,"_63":64},"type","object","required",[],"properties",{},[66,67],"category:home-automation-and-iot","language:python","descriptionMarkdown","Links IoT devices to AI large models using the MCP and MQTT protocols, enabling natural language control, real-time AI responses, and complex instruction execution for interconnected IoT devices.","descriptionPlainText","githubProject",{"_73":74,"_75":76},"readme","# mcp2mqtt: 连接物理世界与AI大模型的桥梁 \n\n[English](README_EN.md) | 简体中文\n\n

\n $\"mcp2mqtt$ \n

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

\n\n## 系统架构\n\n

\n $\"系统架构图\"$ \n

mcp2mqtt 系统架构图

\n\n## 工作流程\n\n

\n $\"工作流程图\"$ \n

mcp2mqtt 工作流程图

\n\n## 项目愿景\n\nmcp2mqtt 是一个将物联网设备接入AI大模型的项目，它通过 Model Context Protocol (MCP) 和 MQTT 协议将物理世界与 AI 大模型无缝连接。最终实现：\n- 用自然语言控制你的硬件设备\n- AI 实时响应并调整物理参数\n- 让你的设备具备理解和执行复杂指令的能力\n- 通过MQTT协议实现设备间的互联互通\n\n## 主要特性\n\n- **智能MQTT通信**\n - 支持MQTT协议的发布/订阅模式\n - 支持多种MQTT服务器（如Mosquitto、EMQ X等）\n - 支持QoS服务质量保证\n - 支持主题过滤和消息路由\n - 实时状态监控和错误处理\n\n- **MCP 协议集成**\n - 完整支持 Model Context Protocol\n - 支持资源管理和工具调用\n - 灵活的提示词系统\n - 通过MQTT实现命令的发布与响应\n\n## 配置说明\n\n### MQTT配置\n```yaml\nmqtt:\n broker: \"localhost\" # MQTT服务器地址\n port: 1883 # MQTT服务器端口\n client_id: \"mcp2mqtt_client\" # MQTT客户端ID\n username: \"mqtt_user\" # MQTT用户名\n password: \"mqtt_password\" # MQTT密码\n keepalive: 60 # 保持连接时间\n topics:\n command:\n publish: \"mcp/command\" # 发送命令的主题\n subscribe: \"mcp/response\" # 接收响应的主题\n status:\n publish: \"mcp/status\" # 发送状态的主题\n subscribe: \"mcp/control\" # 接收控制命令的主题\n```\n\n### 命令配置\n```yaml\ncommands:\n set_pwm:\n command: \"CMD_PWM {frequency}\"\n need_parse: false\n data_type: \"ascii\"\n prompts:\n - \"把PWM调到最大\"\n - \"把PWM调到最小\"\n mqtt_topic: \"mcp/pwm\" # MQTT发布主题\n response_topic: \"mcp/pwm/response\" # MQTT响应主题\n```\n\n## MQTT 命令和响应\n\n### 命令格式\n\n命令使用简单的文本格式：\n\n1. PWM 控制：\n - 命令：`PWM {值}`\n - 示例：\n - `PWM 100`（最大值）\n - `PWM 0`（关闭）\n - `PWM 50`（50%）\n - 响应：`CMD PWM {值} OK`\n\n2. LED 控制：\n - 命令：`LED {状态}`\n - 示例：\n - `LED on`（打开）\n - `LED off`（关闭）\n - 响应：`CMD LED {状态} OK`\n\n3. 设备信息：\n - 命令：`INFO`\n - 响应：`CMD INFO {设备信息}`\n\n### 错误响应\n\n如果发生错误，响应格式将为：\n`ERROR: {错误信息}`\n\n## 支持的客户端\n\nmcp2mqtt 支持所有实现了 MCP 协议的客户端，以及支持MQTT协议的物联网设备：\n\n| 客户端类型 | 特性支持 | 说明 |\n|--------|----------|------|\n| Claude Desktop | 完整支持 | 推荐使用，支持所有 MCP 功能 |\n| Continue | 完整支持 | 优秀的开发工具集成 |\n| Cline | 资源+工具 | 支持多种 AI 提供商 |\n| MQTT设备 | 发布/订阅 | 支持所有MQTT协议的物联网设备 |\n\n## 快速开始\n\n### 1. 安装\n\n#### Windows用户\n下载 [install.py](https://raw.githubusercontent.com/mcp2everything/mcp2mqtt/main/install.py) \n```bash\npython install.py\n```\n#### macOS用户\n```bash\n# 下载安装脚本\ncurl -O https://raw.githubusercontent.com/mcp2everything/mcp2mqtt/main/install_macos.py\n\n# 运行安装脚本\npython3 install_macos.py\n```\n\n#### Ubuntu/Raspberry Pi用户\n```bash\n# 下载安装脚本\ncurl -O https://raw.githubusercontent.com/mcp2everything/mcp2mqtt/main/install_ubuntu.py\n\n# 运行安装脚本\npython3 install_ubuntu.py\n```\n\n安装脚本会自动完成以下操作：\n- 检查系统环境\n- 安装必要的依赖\n- 创建默认配置文件\n- 配置Claude桌面版（如果已安装）\n\n### 手动分步安装依赖\n```bash\nwindows\npowershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"\nMacOS\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n主要依赖uv工具，所以当python和uv以及Claude或Cline安装好后就可以了。\n\n### 基本配置\n在你的 MCP 客户端（如 Claude Desktop 或 Cline）配置文件中添加以下内容：\n注意：如果使用的自动安装那么会自动配置Calude Desktop无需此步。\n使用默认配置文件：\n```json\n{\n \"mcpServers\": {\n \"mcp2mqtt\": {\n \"command\": \"uvx\",\n \"args\": [\n \"mcp2mqtt\"\n ]\n }\n }\n}\n```\n> 注意：修改配置后需要重启Cline或者Claude客户端软件\n## 配置说明\n### 配置文件位置\n复制配置文件（`config.yaml`）可以放在位置：\n用户主目录（推荐个人使用）\n```bash\n# Windows系统\nC:\\Users\\用户名\\.mcp2mqtt\\config.yaml\n\n# macOS系统\n/Users/用户名/.mcp2mqtt/config.yaml\n\n# Linux系统\n/home/用户名/.mcp2mqtt/config.yaml\n```\n- 适用场景：个人配置\n- 需要创建 `.mcp2mqtt` 目录：\n ```bash\n # Windows系统（在命令提示符中）\n mkdir \"%USERPROFILE%\\.mcp2mqtt\"\n \n # macOS/Linux系统\n mkdir -p ~/.mcp2mqtt\n ```\n \n指定配置文件：\n比如指定加载Pico配置文件：Pico_config.yaml\n```json\n{\n \"mcpServers\": {\n \"mcp2mqtt\": {\n \"command\": \"uvx\",\n \"args\": [\n \"mcp2mqtt\",\n \"--config\",\n \"Pico\" //指定配置文件名，不需要添加_config.yaml后缀\n ]\n }\n }\n}\n```\n为了能使用多个mqtt，我们可以新增多个mcp2mqtt的服务指定不同的配置文件名即可。\n如果要接入多个设备，如有要连接第二个设备：\n指定加载Pico2配置文件：Pico2_config.yaml\n```json\n{\n \"mcpServers\": {\n \"mcp2mqtt2\": {\n \"command\": \"uvx\",\n \"args\": [\n \"mcp2mqtt\",\n \"--config\",\n \"Pico2\" //指定配置文件名，不需要添加_config.yaml后缀\n ]\n }\n }\n}\n```\n\n### 硬件连接\n1. 将你的设备通过网络连接到mqtt服务器\n2. 也可以用tests目录下的responder.py来模拟设备\n\n## 运行测试\n\n### 启动设备模拟器\n\n项目在 `tests` 目录中包含了一个设备模拟器。它可以模拟一个硬件设备，能够：\n- 响应 PWM 控制命令\n- 提供设备信息\n- 控制 LED 状态\n\n启动模拟器：\n```bash\npython tests/responder.py\n```\n\n你应该能看到模拟器正在运行并已连接到 MQTT 服务器的输出信息。\n\n### 启动客户端Claude 桌面版或Cline\n

\n $\"Cline$ \n

Example in Cline

\n\n### 从源码快速开始\n1. 从源码安装\n```bash\n# 通过源码安装：\ngit clone https://github.com/mcp2everything/mcp2mqtt.git\ncd mcp2mqtt\n\n# 创建虚拟环境\nuv venv .venv\n\n# 激活虚拟环境\n# Windows:\n.venv\\Scripts\\activate\n# Linux/macOS:\nsource .venv/bin/activate\n\n# 安装开发依赖\nuv pip install --editable .\n```\n\n### MCP客户端配置\n在使用支持MCP协议的客户端（如Claude Desktop或Cline）时，需要在客户端的配置文件中添加以下内容：\n直接自动安装的配置方式\n源码开发的配置方式\n#### 使用默认演示参数：\n```json\n{\n \"mcpServers\": {\n \"mcp2mqtt\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"你的实际路径/mcp2mqtt\", // 例如: \"C:/Users/Administrator/Documents/develop/my-mcp-server/mcp2mqtt\"\n \"run\",\n \"mcp2mqtt\"\n ]\n }\n }\n}\n```\n#### 指定参数文件名\n```json\n{\n \"mcpServers\": {\n \"mcp2mqtt\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"你的实际路径/mcp2mqtt\", // 例如: \"C:/Users/Administrator/Documents/develop/my-mcp-server/mcp2mqtt\"\n \"run\",\n \"mcp2mqtt\",\n \"--config\", // 可选参数，指定配置文件名\n \"Pico\" // 可选参数，指定配置文件名，不需要添加_config.yaml后缀\n ]\n }\n }\n}\n```\n

\n $\"Cline$ \n

Example in Cline

\n### 配置文件位置\n配置文件（`config.yaml`）可以放在不同位置，程序会按以下顺序查找：\n#### 1. 当前工作目录（适合开发测试）\n- 路径：`./config.yaml`\n- 示例：如果你在 `C:\\Projects` 运行程序，它会查找 `C:\\Projects\\config.yaml`\n- 适用场景：开发和测试\n- 不需要特殊权限\n\n#### 2. 用户主目录（推荐个人使用）\n```bash\n# Windows系统\nC:\\Users\\用户名\\.mcp2mqtt\\config.yaml\n\n# macOS系统\n/Users/用户名/.mcp2mqtt/config.yaml\n\n# Linux系统\n/home/用户名/.mcp2mqtt/config.yaml\n```\n- 适用场景：个人配置\n- 需要创建 `.mcp2mqtt` 目录：\n ```bash\n # Windows系统（在命令提示符中）\n mkdir \"%USERPROFILE%\\.mcp2mqtt\"\n \n # macOS/Linux系统\n mkdir -p ~/.mcp2mqtt\n ```\n\n#### 3. 系统级配置（适合多用户环境）\n```bash\n# Windows系统（需要管理员权限）\nC:\\ProgramData\\mcp2mqtt\\config.yaml\n\n# macOS/Linux系统（需要root权限）\n/etc/mcp2mqtt/config.yaml\n```\n- 适用场景：多用户共享配置\n- 创建目录并设置权限：\n ```bash\n # Windows系统（以管理员身份运行）\n mkdir \"C:\\ProgramData\\mcp2mqtt\"\n \n # macOS/Linux系统（以root身份运行）\n sudo mkdir -p /etc/mcp2mqtt\n sudo chown root:root /etc/mcp2mqtt\n sudo chmod 755 /etc/mcp2mqtt\n ```\n\n程序会按照上述顺序查找配置文件，使用找到的第一个有效配置文件。根据你的需求选择合适的位置：\n- 开发测试：使用当前目录\n- 个人使用：建议使用用户主目录（推荐）\n- 多用户环境：使用系统级配置（ProgramData或/etc）\n\n3. 运行服务器：\n```bash\n# 确保已激活虚拟环境\n.venv\\Scripts\\activate\n\n# 运行服务器（使用默认配置config.yaml 案例中用的LOOP_BACK 模拟串口，无需真实串口和串口设备）\nuv run src/mcp2mqtt/server.py\n或\nuv run mcp2mqtt\n# 运行服务器（使用指定配置Pico_config.yaml）\nuv run src/mcp2mqtt/server.py --config Pico\n或\nuv run mcp2mqtt --config Pico\n```\n\n\n## 文档\n\n- [安装指南](./docs/zh/installation.md)\n- [API文档](./docs/zh/api.md)\n- [配置说明](./docs/zh/configuration.md)","url","https://github.com/mcp2everything/mcp2mqtt","githubRepository",{"_79":80,"_81":82,"_83":84,"_88":89,"_92":93},"fullName","mcp2everything/mcp2mqtt","language","Python","owner",{"_85":86,"_87":26},"login","mcp2everything","verified","spdxLicense",{"_90":91},"name","MIT License","stargazers",2,"id",505,"inspectable",true,"mcp2mqtt","npmPackage","prompts","relatedMcpServerIds",[103,104,105,106,107],491,315,361,494,323,"resources","scores",{"_111":112,"_113":112,"_114":112},"license",100,"quality","security","simpleIcon","supportedPlatforms",[118,119,120],"WINDOWS","MACOS","LINUX","tools",[123,135,141],{"_90":124,"_125":126,"_127":128},"set_pwm","description","设置PWM频率，范围0-100","inputSchema",{"_59":60,"_61":129,"_63":131},[130],"frequency",{"_130":132},{"_59":133,"_125":134},"integer","PWM频率值(0-100)",{"_90":136,"_125":137,"_127":138},"get_pico_info","获取Pico开发板信息",{"_59":60,"_61":139,"_63":140},[],{},{"_90":142,"_125":143,"_127":144},"led_control","控制LED开关",{"_59":60,"_61":145,"_63":147},[146],"state",{"_146":148},{"_149":150,"_59":153,"_125":154},"enum",[151,152],"on","off","string","LED状态(on/off)","bunlaxlfyz","updatedAt",["D",1736402580023],"meta",[160,163,165,172,175,177,180,183,186,189,192,194,197,200,202,204,206,208,210],{"_161":162},"title","mcp2mqtt | Glama",{"_164":69,"_90":125},"content",{"_166":167,"_168":169,"_170":171},"href","https://glama.ai/mcp/servers/bunlaxlfyz","rel","canonical","tagName","link",{"_164":98,"_173":174},"property","og:title",{"_164":69,"_173":176},"og:description",{"_164":178,"_173":179},"https://glama.ai/logo.png","og:logo",{"_164":181,"_173":182},"https://glama.ai/mcp/servers/bunlaxlfyz/og-image","og:image",{"_164":184,"_173":185},"630","og:image:height",{"_164":187,"_173":188},"1200","og:image:width",{"_164":190,"_173":191},"website","og:type",{"_164":167,"_173":193},"og:url",{"_164":195,"_173":196},"ChatGPT alternative for power users","og:site_name",{"_164":198,"_90":199},"summary_large_image","twitter:card",{"_164":195,"_90":201},"twitter:title",{"_164":69,"_90":203},"twitter:description",{"_164":181,"_90":205},"twitter:image",{"_164":184,"_90":207},"twitter:image:height",{"_164":187,"_90":209},"twitter:image:width",{"_211":212},"script:ld+json",{"_213":214,"_215":216},"@context","http://schema.org","@graph",[217],{"_213":218,"_219":220,"_221":222},"https://schema.org","@type","BreadcrumbList","itemListElement",[223,230,233,237],{"_219":224,"_225":226,"_90":227,"_228":229},"ListItem","item","https://glama.ai/","Glama","position",1,{"_219":224,"_225":231,"_90":232,"_228":93},"https://glama.ai/mcp","MCP",{"_219":224,"_225":234,"_90":235,"_228":236},"https://glama.ai/mcp/servers","Servers",3,{"_219":224,"_225":167,"_90":98,"_228":238},4,"routes/_public/mcp/servers/~uid/_pages/reviews/_route",{"_52":-5,"_53":241,"_158":271,"_305":-5},{"_55":242,"_57":243,"_37":246,"_68":69,"_70":69,"_71":247,"_77":248,"_94":95,"_96":97,"_90":98,"_99":-5,"_100":-5,"_101":251,"_108":-5,"_109":252,"_115":-5,"_116":253,"_121":254,"_41":155,"_156":270},["D",1735550975887],{"_59":60,"_61":244,"_63":245},[],{},[66],{"_73":74,"_75":76},{"_79":80,"_81":82,"_83":249,"_88":250,"_92":93},{"_85":86,"_87":26},{"_90":91},[103,104,105,106,107],{"_111":112,"_113":112,"_114":112},[118,119,120],[255,260,264],{"_90":124,"_125":126,"_127":256},{"_59":60,"_61":257,"_63":258},[130],{"_130":259},{"_59":133,"_125":134},{"_90":136,"_125":137,"_127":261},{"_59":60,"_61":262,"_63":263},[],{},{"_90":142,"_125":143,"_127":265},{"_59":60,"_61":266,"_63":267},[146],{"_146":268},{"_149":269,"_59":153,"_125":154},[151,152],["D",1736402580023],[272,274,275,277,279,280,281,282,283,284,285,286,287,288,289,290,291,292,293],{"_161":273},"Reviews | mcp2mqtt | Glama",{"_164":69,"_90":125},{"_166":276,"_168":169,"_170":171},"https://glama.ai/mcp/servers/bunlaxlfyz/reviews",{"_164":278,"_173":174},"Reviews | mcp2mqtt",{"_164":69,"_173":176},{"_164":178,"_173":179},{"_164":181,"_173":182},{"_164":184,"_173":185},{"_164":187,"_173":188},{"_164":190,"_173":191},{"_164":276,"_173":193},{"_164":195,"_173":196},{"_164":198,"_90":199},{"_164":195,"_90":201},{"_164":69,"_90":203},{"_164":181,"_90":205},{"_164":184,"_90":207},{"_164":187,"_90":209},{"_211":294},{"_213":214,"_215":295},[296],{"_213":218,"_219":220,"_221":297},[298,299,300,301,302],{"_219":224,"_225":226,"_90":227,"_228":229},{"_219":224,"_225":231,"_90":232,"_228":93},{"_219":224,"_225":234,"_90":235,"_228":236},{"_219":224,"_225":167,"_90":98,"_228":238},{"_219":224,"_225":276,"_90":303,"_228":304},"Reviews",5,"review","actionData","errors"]

Rate & Review