LED Controller - MCP Arduino Interface

Proyecto de aprendizaje que integra robótica básica con el Model Context Protocol (MCP), permitiendo controlar un Arduino mediante comandos enviados a través de un servidor MCP.

Propósito

Servir como primera aproximación al control de hardware mediante MCP, estableciendo una comunicación bidireccional entre Claude (u otro cliente MCP) y una placa Arduino ELEGOO conectada por puerto serial.

Componentes

• Programa Arduino (controler.cpp): Código para compilar en la placa ELEGOO desde el IDE Arduino
• Servidor Serial (first_con.py): Puente TCP-Serial que comunica con el Arduino
• Servidor MCP (first_mcp.py): Expone herramientas MCP para control desde Claude
• Configuración MCP: Archivo de configuración para cliente Claude (incluido en repositorio)

Instalación

1. Instalar dependencias con uv:

uv add fastmcp pyserial

2. Cargar controler.cpp en la placa ELEGOO usando el IDE de Arduino

3. Configurar el servidor MCP en el cliente de Claude usando el archivo de configuración incluido

Uso

Ejecutar el servidor MCP:

uv run first_mcp.py

Desde Claude, utilizar las herramientas:

• encender_canal(): Inicializa conexión con Arduino
• arduino_cmd(cmd): Envía comandos al controlador

Arquitectura

Cliente MCP (Claude)
    ↓
Servidor MCP (first_mcp.py)
    ↓
Servidor Socket (first_con.py:5678)
    ↓
Arduino ELEGOO (COM3, serial)

Notas

Primera versión de aprendizaje con MCP y robótica básica. No optimizada para producción.