ESP32-C6 MCP Server

This project implements an MCP (Model Context Protocol) server running on ESP32-C6 that connects to WiFi, gets an IP address via DHCP, and exposes MCP functionality that can be accessed by Warp.

Project Structure

• esp32-c6-mcp-rs/ - ESP32-C6 firmware with WiFi and MCP server
• esp32-mcp-bridge/ - Rust bridge tool for connecting Warp to ESP32 MCP server
• desktop-qr-code-mcp/ - Reference desktop MCP server for QR code generation

Features

• WiFi Connection: Automatically connects to WiFi and obtains IP via DHCP
• MCP Server: Implements MCP protocol over TCP on port 3000
• WiFi Status Tool: MCP tool to check WiFi connection status and network info
• Bridge Tool: Pure Rust bridge for connecting Warp to ESP32 MCP server

Prerequisites

• Rust toolchain with ESP32 target support
• ESP-HAL v1.0.0-rc.0
• WiFi network credentials (SSID and PASSWORD)

Building and Flashing ESP32-C6 Firmware

1. Set environment variables for WiFi credentials:

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

2. Build and flash the firmware:

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

3. Monitor the output to see the IP address assigned by DHCP:

   cargo monitor
   

Building the Bridge Tool

The bridge tool allows Warp to communicate with the ESP32 MCP server:

cd esp32-mcp-bridge
cargo build --release

Using the Bridge with Warp

1. First, make sure your ESP32-C6 is running and connected to WiFi
2. Note the IP address from the ESP32 serial output
3. Configure Warp to use the bridge tool as an MCP server

Option 1: Direct Command Line Usage

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

Option 2: Warp Configuration

Add this to your Warp MCP configuration:

{
  "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"]
    }
  }
}

Available MCP Tools

The ESP32 MCP server provides the following tools:

wifi_status

• Description: Get WiFi connection status and IP information
• Parameters:
  • detailed (optional boolean): Include detailed connection info
• Returns: Current WiFi status, IP address, signal strength, and connected SSID

led_control

• Description: Control the onboard SmartLED/NeoPixel on GPIO8
• Parameters:
  • color (string): Predefined color name - "red", "green", "blue", "yellow", "magenta", "cyan", "white", "off"
  • r (integer 0-255): Red component for custom RGB colors
  • g (integer 0-255): Green component for custom RGB colors
  • b (integer 0-255): Blue component for custom RGB colors
  • brightness (integer 0-100): Brightness percentage
• Returns: Confirmation of LED color and brightness settings

compute_add

• Description: Add two floating-point numbers
• Parameters:
  • a (number, required): First number
  • b (number, required): Second number
• Returns: Sum of the two numbers

compute_multiply

• Description: Multiply two floating-point numbers
• Parameters:
  • a (number, required): First number
  • b (number, required): Second number
• Returns: Product of the two numbers

LED Status Indicators

The ESP32-C6's onboard LED provides visual feedback:

• 🔵 Blue (20% brightness): System ready, no MCP client connected
• 🟢 Green (20% brightness): MCP client connected and active
• ⚫ Off: Device not running or LED manually turned off

Example AI Assistant Prompts

Once connected to Warp with MCP, you can use these natural language prompts:

LED Control Examples

"Turn the ESP32 LED red"
"Set the ESP32 LED to blue with 50% brightness"
"Change the LED to green and make 

... [View full README on GitHub](https://github.com/georgik/esp32-mcp-server#readme)