Shelly集成（MCP+REST API）
将Shelly Cloud连接到世界上任何东西的集成项目！
 ](https://hub.docker.com/r/giogdev/shelly-cloud-mcp-server) ](https://hub.docker.com/r/giogdev/shelly-cloud-mcp-server)
](https://hub.docker.com/r/giogdev/shelly-api-gateway) ](https://hub.docker.com/r/giogdev/shelly-api-gateway)
该项目提供了两个可以作为容器运行的独立组件：
- MCP服务器 --为AI助手公开MCP服务器
- REST API网关 --为仪表板、家庭自动化平台和任何支持REST的客户端公开REST Api
⬆️ _此API项目作为n8n代理工具的使用示例_
🏆 第一名 在“工匠”类别中 雪莉智能家居挑战2025 🏆
初创公司
您可以在docker hub和docker compose目录中找到这些项目。
- 如果你想启动MCP服务器 .
- 如果要启动API rest端点 .
使用示例
- 我将此项目（api）用作 AI代理，目的是从以下来源获取历史/实时数据 雪莉气象站
- 从AI代理（如n8n或OpenClaw）控制外壳设备🦞)
- 获取天气历史信息
文档
- 项目结构 --每个项目的解决方案布局、目的和内容
- MCP服务器 --配置、Docker设置、Claude Desktop和Claude Code集成
- REST API网关 --可用端点、Docker设置、如何启用或禁用服务
- 设备加载和存储初始化 -设备存储在启动时的初始化方式、加载优先级以及本地文件和ShellyCloudneneneba API之间的合并逻辑
安全
此项目不实现安全令牌或身份验证，因为它被设计为在受保护的环境中运行，而不会暴露于外部世界。
设备映射文件
docs/resources/template/devices.template.json 是用于在本地定义设备的JSON模板。它将物理设备ID映射到MCP工具和REST端点使用的友好名称。复制并填写以使用本地映射文件（请参阅 DeviceMappingFile 配置键）。
更新日志
看 更改日志.md 查看完整版本历史。
许可证
该项目根据 GNU GPL v3.
- 任何人都可以复制、修改和分发此软件。
- 您必须在每次分发时都包含许可和版权声明。
- 您可以私下使用此软件。
- 您可以将此软件用于商业目的。
- 如果你敢于仅从这段代码构建你的业务，你就有可能将整个代码库开源。
- 如果你修改了它，你必须指出对代码所做的更改。
- 此代码库的任何修改都必须使用相同的许可证GPLv3分发。
- 本软件不提供保修。
- 软件作者或许可证不对软件造成的任何损害负责。