我们很高兴地宣布 ThingsPanel MCP 正式开源。这是一个基于 Model Context Protocol (MCP) 的服务器实现,旨在为 ThingsPanel 物联网平台提供 AI 模型集成能力。
项目简介
ThingsPanel MCP 是一个轻量级的中间件,它使得 AI 模型(如 Claude、GPT 等)能够以标准化的方式与物联网设备进行交互。通过实现 Model Context Protocol,它提供了一个安全、可控的接口,使 AI 模型能够:
- 查询和管理物联网设备
- 获取设备历史数据
- 处理设备告警
- 执行设备控制命令
技术特点
标准化接口
- 完整实现 Model Context Protocol 规范
- 支持 stdio 和 SSE 传输方式
- RESTful API 设计
模块化架构
- 核心功能模块化设计
- 插件式工具扩展
- 支持按需启用/禁用功能
开发友好
- 完整的类型提示
- 异步 I/O 支持
- 详细的 API 文档
部署灵活
- 提供 Docker 支持
- 支持环境变量配置
- 最小化外部依赖
适用场景
项目特别适合以下场景的技术团队:
需要为物联网平台添加 AI 能力
正在开发 AI 助手,需要物联网集成能力
构建智能运维系统
快速上手
安装
pip install thingspanel-mcp
配置
export THINGSPANEL_API_KEY="您的API密钥"
运行
thingspanel-mcp
技术栈
- 语言:Python 3.8+
- 传输协议:Model Context Protocol
- API 风格:RESTful
- 容器化:Docker & Docker Compose
- 测试框架:pytest
- 代码质量:mypy, black, isort
开源信息
后续规划
我们计划在保持项目稳定性的同时,逐步添加以下功能:
- 批量设备操作支持
- 设备分组管理
- 数据统计分析接口
- Webhook 支持
- 更多第三方集成
参与贡献
我们欢迎社区贡献,无论是:
技术支持
- GitHub Issues:技术问题讨论
- 项目文档:使用指南和 API 文档
- 示例代码:标准用例实现
这个项目的目标是为物联网开发者提供一个实用、可靠的工具,帮助他们更容易地将 AI 能力集成到物联网应用中。我们注重代码质量和文档完整性,希望能为社区提供一个值得信赖的解决方案。
欢迎各位开发者试用和反馈,一起推动项目进步!