Arduino MCP Server
arduino-mcp-server
Dale a tu asistente de IA control total sobre Arduino: compilar, subir, monitorear el puerto serie y verificar la seguridad del cableado, todo mediante lenguaje natural.
Parte del ecosistema HardwareMCP — servidores MCP de código abierto que conectan la IA con hardware físico.
Qué hace esto
Los asistentes de IA pueden controlar Jira, GitHub y bases de datos. No pueden hablar con un microcontrolador, hasta ahora.
arduino-mcp-server envuelve arduino-cli en un servidor MCP para que tu IA pueda:
Detectar placas y puertos conectados automáticamente
Compilar y subir sketches sin tocar la terminal
Monitorear la salida serie con sesiones con estado (abrir, leer, esperar, escribir, cerrar)
Ejecutar comprobaciones de seguridad eléctrica antes de enviar comandos al hardware
Gestionar dependencias — núcleos, librerías e instalación de CLI
Related MCP server: Arduino MCP Server (Simple)
Inicio rápido
Instalación:
npm install -g arduino-mcp-serverAñadir a Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"arduino": {
"command": "npx",
"args": ["-y", "arduino-mcp-server"],
"env": {
"ARDUINO_CLI_PATH": "arduino-cli",
"ARDUINO_SKETCH_ROOT": "/path/to/your/sketches"
}
}
}
}Requiere arduino-cli en tu PATH, o deja que el servidor lo instale por ti.
Lo que puedes decir
"Comprueba si Arduino CLI está instalado y configura todo para un Arduino Uno."
"Compila mi sketch Blink y súbelo al Uno en COM6."
"Abre el puerto serie en COM6 a 115200 y espera hasta que el dispositivo imprima READY."
"Ejecuta una verificación previa de seguridad para un Arduino Uno con 5V en el pin 13 a 25mA antes de enviar comandos."
Herramientas
Herramienta | Qué hace |
| Comprueba la instalación y versión de Arduino CLI |
| Guía a través de la instalación de arduino-cli |
| Detecta placas conectadas e infiere FQBNs |
| Lista todas las placas Arduino conectadas |
| Lista los puertos serie disponibles |
| Comprueba/instala núcleos de placas |
| Compila un sketch para una placa objetivo |
| Sube el sketch compilado a una placa |
| Sube y espera la señal de listo del dispositivo |
| Abre una sesión serie con estado |
| Lee datos serie almacenados en búfer |
| Espera un patrón en la salida serie |
| Envía datos a través del puerto serie |
| Cierra una sesión serie |
| Lista sesiones serie activas |
| Lectura serie rápida de una sola vez |
| Comprobación de seguridad eléctrica antes de operaciones de hardware |
| Obtiene detalles de pines/capacidades de una placa |
| Lista todas las placas que soporta arduino-cli |
| Navega por la referencia de pines de placas |
| Busca en la referencia de placas por palabra clave |
Recursos:
arduino://boards/reference— referencia estructurada de pines/capacidades de placas
Prompts:
arduino-cli-bootstrap-policy— política para el comportamiento de configuración de arduino-cliarduino-setup-assistant— asistente guiado para la configuración del entorno Arduino
Configuración
Variable | Predeterminado | Descripción |
|
| Ruta al binario de arduino-cli |
| (ninguno) | Restringe las rutas de sketches a este directorio |
Desarrollo
git clone https://github.com/hardware-mcp/arduino-mcp-server
cd arduino-mcp-server
npm install
npm run typecheck
npm run build
npm run devParte de HardwareMCP
Este servidor es parte del ecosistema HardwareMCP — una colección de servidores MCP que dan a los asistentes de IA control real sobre hardware físico.
Licencia
MIT — ver LICENSE.
Soporte
Available Tools
21 toolsarduino_cli_doctorArduino CLI DoctorARead-only
Check whether arduino-cli is available and return OS-specific installation instructions if missing.
Inputs: no named parameters. Returns: ok, raw, data, note, +9 more
compile_sketchCompile SketchADestructiveIdempotent
Compile an Arduino sketch with a specific board FQBN.
Inputs: fqbn (required), sketchPath (required), clean, warnings, +3 more. Returns: ok, raw, data, note, +9 more
detect_hardwareDetect HardwareBRead-only
Detect connected Arduino-compatible hardware, infer board/FQBN candidates, and generate next compile/upload commands.
Inputs: port, includeBoardDetails. Returns: ok, raw, data, note, +9 more
ensure_core_installedEnsure Core InstalledADestructiveIdempotent
Ensure the Arduino core required by a board FQBN is installed. Can auto-install via arduino-cli core install.
Inputs: fqbn, coreId, autoInstall. Returns: ok, raw, data, note, +9 more
get_board_detailsGet Board DetailsARead-only
Get detailed board metadata from arduino-cli for a specific FQBN.
Inputs: fqbn (required). Returns: ok, raw, data, note, +9 more
install_arduino_cliInstall Arduino CLIADestructiveIdempotent
Attempt to install arduino-cli for the current OS using available package managers, then verify and configure CLI path.
Inputs: method, setCliPathInProcess. Returns: ok, raw, data, note, +9 more
list_board_referenceList Board ReferenceARead-only
List local board reference entries with pin/spec metadata.
Inputs: no named parameters. Returns: ok, raw, data, note, +9 more
list_connected_boardsList Connected BoardsARead-only
List connected boards and serial ports detected by arduino-cli.
Inputs: no named parameters. Returns: ok, raw, data, note, +9 more
list_serial_portsList Serial PortsARead-only
List serial ports and any detected board metadata using arduino-cli. Works on Windows/macOS/Linux.
Inputs: no named parameters. Returns: ok, raw, data, note, +9 more
list_supported_boardsList Supported BoardsARead-only
List supported/installable boards from the local arduino-cli index.
Inputs: search. Returns: ok, raw, data, note, +9 more
read_serial_snapshotRead Serial SnapshotBRead-only
Capture serial output for a bounded duration from a given port.
Inputs: port (required), baudRate, durationMs. Returns: ok, raw, data, note, +9 more
safety_preflightSafety PreflightARead-only
Run electrical preflight checks (voltage/current/pin risks) before upload or serial write operations.
Inputs: fqbn, port, board, power, +1 more. Returns: ok, raw, data, note, +9 more
search_board_referenceSearch Board ReferenceARead-only
Search local board reference by board name, alias, id, or FQBN.
Inputs: query (required). Returns: ok, raw, data, note, +9 more
serial_close_sessionSerial Close SessionADestructiveIdempotent
Close a serial session and release its port lock.
Inputs: sessionId (required). Returns: ok, raw, data, note, +9 more
serial_expectSerial ExpectARead-only
Wait for a string pattern in a serial session buffer with timeout.
Inputs: pattern (required), sessionId (required), timeoutMs, fromOffset, +1 more. Returns: ok, raw, data, note, +9 more
serial_list_sessionsSerial List SessionsARead-only
List active serial sessions and current port lock state.
Inputs: no named parameters. Returns: ok, raw, data, note, +9 more
serial_open_sessionSerial Open SessionADestructive
Open a stateful serial monitor session with port lock ownership.
Inputs: port (required), ttlMs, baudRate, maxBufferBytes. Returns: ok, raw, data, note, +9 more
serial_readSerial ReadARead-only
Read buffered bytes from an open serial session.
Inputs: sessionId (required), encoding, maxBytes, fromOffset. Returns: ok, raw, data, note, +9 more
serial_writeSerial WriteADestructive
Write bytes to an open serial session. Safety preflight is enforced unless explicitly skipped.
Inputs: data (required), sessionId (required), encoding, lineEnding, +2 more. Returns: ok, raw, data, note, +9 more
upload_and_wait_readyUpload And Wait ReadyADestructive
Upload a sketch and wait for a serial readiness pattern, handling post-upload reset/re-enumeration windows.
Inputs: port (required), sketchPath (required), fqbn, verify, +7 more. Returns: ok, raw, data, note, +9 more
upload_sketchUpload SketchBDestructiveIdempotent
Upload a compiled sketch to a connected board/port.
Inputs: port (required), sketchPath (required), fqbn, verify, +3 more. Returns: ok, raw, data, note, +9 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 21 tools
Several tools cluster around board/port discovery (list_connected_boards, list_serial_ports, detect_hardware) and serial reading (serial_read, read_serial_snapshot), so an agent could select the wrong one without careful description reading. Most other tools have clear resource-action targets, but these near-duplicates lower the boundary clarity.
Names are consistently snake_case and mostly verb_noun (list_*, install_*, compile_*, upload_*). The serial_* prefix group is internally consistent, but read_serial_snapshot and upload_and_wait_ready deviate from the dominant pattern.
At 21 tools the server sits in the heavy 16-25 band, but the broad scope of Arduino CLI management, board detection, compile/upload, and serial sessions gives most tools a purpose. It is slightly over the ideal compact size but not excessive.
The workflow from CLI setup, board detection, core installation, compile, upload, and serial interaction is well covered, including safety preflight. Notable gaps are library management (search/install) and core uninstall/removal, but agents can complete core Arduino tasks without them.
Related MCP Connectors
Build, validate, test-run and publish AIOS workflows from Claude Code, Codex, Cursor or VS Code.
Checks AI-written code for leaked keys and made-up packages, on your machine. Never uploads code.
Build, check and open Arduino, ESP32 and Pico circuits with code in the Mokxi simulator.
Generate SBOMs, scan vulnerabilities, and analyze dependencies from local projects or Git repos.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Arduino development through arduino-cli, allowing sketch management, code compilation and uploading, library and board operations, serial monitoring, and AI-powered circuit diagram generation using WireViz.32 PyPI10MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with Arduino boards for compiling, uploading sketches, and serial communication.6MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to compile, upload, and monitor Arduino boards via natural language, with electrical safety checks and dependency management.21202 npm26MIT
- FlicenseAqualityCmaintenanceA local stdio MCP server wrapping arduino-cli to let agents detect boards, manage cores/libraries, compile and upload sketches, and communicate over serial, enabling hardware control without shell gymnastics.17-