Esp32 MCP Server (Georgik)

ESP32-C6 MCP服务器

该项目实现了一个在ESP32-C6上运行的MCP（模型上下文协议）服务器，该服务器连接到WiFi，通过DHCP获取IP地址，并公开了可由Warp访问的MCP功能。

项目结构

• esp32-c6-mcp-rs/ -ESP32-C6固件，带WiFi和MCP服务器
• esp32-mcp-bridge/ -用于将Warp连接到ESP32 MCP服务器的Rust桥接工具
• desktop-qr-code-mcp/ -参考桌面MCP服务器生成二维码

特性

• WiFi连接：自动连接到WiFi并通过DHCP获取IP
• MCP服务器：在端口3000上通过TCP实现MCP协议
• WiFi状态工具：MCP工具，用于检查WiFi连接状态和网络信息
• 桥接工具：用于将Warp连接到ESP32 MCP服务器的纯Rust网桥

先决条件

• 支持ESP32目标的Rust工具链
• ESP-HAL v1.0.0-rc.0
• WiFi网络凭据（SSID和密码）

构建和刷新ESP32-C6固件

1. 设置WiFi凭据的环境变量：

   export SSID="YourWiFiNetwork"
   export PASSWORD="YourWiFiPassword"

1. 构建并刷新固件：

   cd esp32-c6-mcp-rs
   cargo build --release  # Always build with --release for embedded targets
   cargo run --release    # This will flash the firmware

1. 监视输出以查看DHCP分配的IP地址：

   cargo monitor

构建桥梁工具

桥接工具允许Warp与ESP32 MCP服务器通信：

cd esp32-mcp-bridge
cargo build --release

使用扭曲的桥梁

1. 首先，确保您的ESP32-C6正在运行并连接到WiFi
2. 注意ESP32串行输出的IP地址
3. 配置Warp以将网桥工具用作MCP服务器

选项1：直接使用命令行

./target/release/esp32-mcp-bridge --esp32-ip 192.168.1.100 --port 3000

选项2：曲速配置

将此添加到扭曲MCP配置中：

{
  "mcpServers": {
    "esp32-mcp": {
      "command": "/path/to/esp32-mcp-server/esp32-mcp-bridge/target/release/esp32-mcp-bridge",
      "args": ["--esp32-ip", "192.168.1.100", "--port", "3000"]
    }
  }
}

可用的MCP工具

ESP32 MCP服务器提供以下工具：

wifi_status

• 描述：获取WiFi连接状态和IP信息
• 参数:

- detailed （可选布尔值）：包括详细的连接信息

• 退货：当前WiFi状态、IP地址、信号强度和连接的SSID

led_control

• 描述：在GPIO8上控制板载SmartLED/NeoPixel
• 参数:

- color （字符串）：预定义的颜色名称-“红色”、“绿色”、“蓝色”、“黄色”、“品红色”、（青色）、“白色”、“关闭” - r （整数0-255）：自定义RGB颜色的红色分量 - g （整数0-255）：自定义RGB颜色的绿色分量 - b （整数0-255）：自定义RGB颜色的蓝色分量 - brightness （整数0-100）：亮度百分比

• 退货：确认LED颜色和亮度设置

compute_add

• 描述：添加两个浮点数
• 参数:

- a （数字，必填）：第一个数字 - b （数字，必填）：第二个数字

• 退货：两个数字的总和

compute_multiply

• 描述：将两个浮点数相乘
• 参数:

- a （数字，必填）：第一个数字 - b （数字，必填）：第二个数字

• 退货：两个数字的乘积

LED状态指示灯

ESP32-C6的板载LED提供视觉反馈：

• 🔵 蓝色（20%亮度）：系统就绪，未连接MCP客户端
• 🟢 绿色（20%亮度）：MCP客户端已连接并处于活动状态
• ⚫ 关：设备未运行或LED手动关闭

AI助手提示示例

使用MCP连接到Warp后，您可以使用以下自然语言提示：

LED控制示例

"Turn the ESP32 LED red"
"Set the ESP32 LED to blue with 50% brightness"
"Change the LED to green and make it dim (20% brightness)"
"Set the ESP32 LED to RGB(128, 64, 255) with 75% brightness"
"Make the LED purple using RGB values"
"Turn off the ESP32 LED"

WiFi状态示例

"Check the WiFi status of my ESP32"
"Is my ESP32 connected to WiFi?"
"Show me detailed WiFi information from the ESP32 including signal strength"

数学计算示例

"Ask the ESP32 to calculate 15.5 + 23.7"
"Use my ESP32 to add two numbers: 42 and 38"
"Have the ESP32 multiply 12.5 by 8.2"
"Calculate 25 × 16 using the ESP32"

组合操作示例

"Check my ESP32's WiFi status, then turn the LED green if connected"
"Set the ESP32 LED to yellow, check WiFi status, then calculate 100 + 200"
"If my ESP32 is connected to WiFi, turn the LED blue, otherwise turn it red"

创意实例

"Make the ESP32 LED show different colors to indicate system status"
"Use the ESP32 LED as a status indicator - green for good WiFi, red for problems"
"Create a light show on my ESP32 by setting different colors and brightness levels"
"Set up the ESP32 LED to indicate calculation results with different colors"

建筑

Warp Terminal
    ↓ (stdin/stdout JSON-RPC)
ESP32 MCP Bridge (Rust)
    ↓ (TCP JSON-RPC)
ESP32-C6 MCP Server

桥接工具处理Warp的stdin/stdout MCP通信和ESP32的基于TCP的MCP服务器之间的协议转换。

发展

ESP32-C6开发

• 固件使用Embassy异步运行时进行高效的任务处理
• WiFi凭据在编译时通过环境变量设置
• JSON处理使用 serde-json-core no-std兼容性
• 堆分配用于网络缓冲区（128KB堆）

桥梁开发

• 使用Tokio构建异步TCP网络
• 处理双向JSON-RPC消息转发
• 包括连接超时和错误处理
• 支持详细日志记录以进行调试

故障排除

ESP32未连接到WiFi

• 检查SSID和PASSWORD环境变量
• 验证WiFi网络为2.4GHz（ESP32-C6不支持5GHz）
• 检查串行输出是否存在连接错误

桥梁连接问题

• 确保ESP32已通过DHCP获得IP地址
• 验证网桥命令中的IP地址是否与ESP32的IP匹配
• 检查网络上的防火墙设置
• 试试看 --verbose 详细日志记录标志

曲速集成问题

• 验证Warp配置中的桥接刀具路径
• 检查桥接工具是否成功构建
• 在启动Warp之前，确保ESP32正在运行且可访问

网络安全注意事项

• 这是一个开发/原型实现
• WiFi凭据在编译时嵌入固件中
• MCP服务器接受来自网络上任何客户端的连接
• 对于生产使用，考虑添加身份验证和加密