物联网设备服务器

基于ESP32的物联网设备服务器,实现模型上下文协议(MCP),提供WiFi管理、WebSocket通信和现代Web界面等功能。

  • by LightHouseIL
  • C++
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 lighthouseil/lighthouse-mcp-esp-server

使用说明

LightHouse MCP-ESP服务器

一个功能强大的基于ESP32的服务器,为物联网设备实现模型上下文协议(MCP)。该项目为构建具有WiFi管理、WebSocket通信和现代web界面等功能的物联网应用程序提供了坚实的基础。

特性

  • WiFi管理

    • 未找到凭据时的自动AP模式
    • 安全的凭证存储
    • 自动重新连接处理
    • 基于Web的WiFi配置
  • MCP协议实现

    • 资源发现和管理
    • 通过WebSocket实时更新
    • 符合JSON-RPC 2.0标准
    • 资源更新订阅系统
  • web界面

    • 现代、灵敏的设计
    • 交互式MCP命令控制台
    • 实时状态更新
    • 带示例的学习中心

需求

  • ESP32开发板
  • 平台IO IDE或Arduino IDE
  • 所需库:
    • ESPAsyncWebServer
    • 异步TCP
    • ArduinoJson
    • LittleFS
    • 偏好设置

安装

  1. 克隆存储库:

    git clone https://github.com/yourusername/LightHouse-MCP-ESP-Server.git
    cd LightHouse-MCP-ESP-Server
    
  2. 安装依赖项:

    pio pkg install
    
  3. 构建和上传:

    pio run -t upload
    
  4. 上传文件系统:

    pio run -t uploadfs
    

用法

  1. 打开ESP32的电源
  2. 连接到ESP32的WiFi网络(SSID格式:ESP32_XXXXXX)
  3. 打开web浏览器并导航到:
    • http://192.168.4.1 -主界面
    • http://192.168.4.1/mcp_basics.html -MCP学习中心

发展

项目结构

├── data/               # Web interface files
├── src/               # Source code
├── include/           # Header files
├── test/              # Unit tests
└── platformio.ini     # Project configuration

添加新功能

  1. 在中创建新的MCP资源 include/MCPTypes.h
  2. 在中实现处理程序 src/MCPServer.cpp
  3. 在中添加web界面组件 data/

许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。

贡献

  1. 分叉存储库
  2. 创建功能分支(git checkout -b feature/AmazingFeature)
  3. 提交您的更改(git commit -m 'Add some AmazingFeature')
  4. 推到分支(git push origin feature/AmazingFeature)
  5. 打开拉取请求

致谢

  • ESP32 Arduino核心团队
  • 平台IO团队
  • 所有贡献者和用户