ESP32 MCP Server

ESP32 MCP Server

site icon
2025.01.18 7
C++物联网设备监控其它
ESP32 MCP Server 是一个基于 ESP32 微控制器的 Model Context Protocol (MCP) 实现,提供基于 WebSocket 的接口用于资源发现和监控。该服务器具有实时更新、资源发现、WiFi 配置等功能,适用于物联网设备监控和管理场景。
View on GitHub

Overview

基本能力

产品定位

ESP32 MCP Server 是一个为 ESP32 微控制器设计的 MCP 协议实现,主要用于物联网设备的资源发现和监控。

核心功能

  • MCP 协议实现(v0.1.0)
  • 用于实时更新的 WebSocket 服务器
  • 资源发现和监控
  • 通过 Web 界面配置 WiFi
  • 线程安全的请求处理
  • 全面的测试套件
  • AsyncWebServer 集成
  • 用于配置存储的 LittleFS 支持

适用场景

  • 物联网设备监控
  • 资源发现和管理
  • 实时数据更新

工具列表

  • PlatformIO Core (CLI) 或 PlatformIO IDE:用于构建和上传固件
  • Python 3.7 或更高版本:用于运行测试和脚本
  • Git:用于版本控制

常见问题解答

  • 项目当前状态为 "Not Compiling",初始提交可能存在编译问题
  • 需要 ESP32 S3 DevKitC-1 开发板

使用教程

使用依赖

硬件

  • ESP32 S3 DevKitC-1 开发板
  • 用于编程的 USB 数据线

软件

  • PlatformIO Core (CLI) 或 PlatformIO IDE
  • Python 3.7 或更高版本
  • Git

安装教程

  1. 克隆仓库:
git clone https://github.com/yourusername/esp32-mcp-server.git
cd esp32-mcp-server
  1. 安装依赖:
pio pkg install
  1. 构建并上传文件系统:
pio run -t uploadfs
  1. 构建并上传固件:
pio run -t upload

调试方式

  1. 运行所有测试:
pio test -e native
  1. 运行特定测试:
pio test -e native -f test_request_queue
  1. 运行覆盖率测试:
pio test -e native --coverage

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。