Shelly集成服务

连接Shelly云与全球任何设备的集成项目,提供MCP服务器和REST API网关功能。

  • by giogdev
  • C#
  • 本地部署
  • 更新于
在 GitHub 查看 giogdev/shelly.mcpserver

使用说明

Shelly集成(MCP+REST API)

将Shelly Cloud连接到世界上任何东西的集成项目!

该项目提供了两个可以作为容器运行的独立组件:

  • MCP服务器 --为AI助手公开MCP服务器
  • REST API网关 --为仪表板、家庭自动化平台和任何支持REST的客户端公开REST Api

⬆️ 此API项目作为n8n代理工具的使用示例

🏆 第一名 在“工匠”类别中 雪莉智能家居挑战2025 🏆

初创公司

您可以在docker hub和docker compose目录中找到这些项目。

使用示例

  • 我将此项目(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.

  1. 任何人都可以复制、修改和分发此软件。
  2. 您必须在每次分发时都包含许可和版权声明。
  3. 您可以私下使用此软件。
  4. 您可以将此软件用于商业目的。
  5. 如果你敢于仅从这段代码构建你的业务,你就有可能将整个代码库开源。
  6. 如果你修改了它,你必须指出对代码所做的更改。
  7. 此代码库的任何修改都必须使用相同的许可证GPLv3分发。
  8. 本软件不提供保修。
  9. 软件作者或许可证不对软件造成的任何损害负责。