Communitygithub.com

Adancurusul/serial-mcp-server

Servidor MCP y CLI en Rust para dispositivos serie/UART, con automatización mediante macros JSON y habilidades de agente para flujos de trabajo temporizados repetibles.

¿Qué es serial-mcp-server?

Esta habilidad proporciona un servidor MCP y una interfaz de línea de comandos (CLI) escrita en Rust para interactuar con dispositivos serie/UART. Es útil para desarrolladores y agentes de IA que necesitan automatizar flujos de trabajo de comunicación serie, como pruebas de hardware, envío y recepción de datos, y control de líneas de señal (RTS/DTR). La habilidad admite plataformas como Claude Code, Cursor y otros asistentes que integren MCP. Su enfoque principal es operar a través de la CLI, a menos que se solicite explícitamente el uso del protocolo MCP. Ofrece un potente sistema de macros basado en JSON (DSL) para definir secuencias repetibles de comandos serie, que incluyen enviar datos, esperar respuestas con patrones de coincidencia, y organizar ensambles de macros. El servidor se encarga de mantener la salida estándar separada de los mensajes de diagnóstico, y requiere que el agente cite comandos exactos y base el éxito del hardware en evidencia real del dispositivo. La habilidad incluye un flujo de trabajo completo: desde verificar la disponibilidad del binario, listar puertos, hacer pruebas de sondeo, hasta ejecutar macros planificadas y validadas antes de operar sobre hardware real.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add Adancurusul/serial-mcp-server

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Depuración Serie

Regla de Operación

Use primero la CLI serial-mcp-server a menos que el usuario solicite explícitamente MCP o que un cliente MCP ya esté configurado. Mantenga los datos de stdout separados de los diagnósticos, cite comandos exactos y base el éxito del hardware en evidencia real de comandos del dispositivo.

Flujo de Trabajo

  1. Confirme que el binario está disponible:
serial-mcp-server --help
  1. Enumere los puertos disponibles antes de elegir un dispositivo:
serial-mcp-server list-ports --json
  1. Para una prueba rápida del dispositivo, primero sondee el puerto, luego escriba/lea solo si el sondeo tiene éxito:
serial-mcp-server probe --port <puerto> --baud 115200 --json
serial-mcp-server write --port <puerto> --baud 115200 --data H --read --timeout-ms 1000 --json
  1. Si RTS o DTR están involucrados, indique los niveles de línea solicitados y use el comando de líneas de control:
serial-mcp-server set-control-lines --port <puerto> --rts high --dtr low --json
  1. Para procedimientos serie repetibles, prefiera paquetes de macros JSON y valídelos o planifíquelos antes de la ejecución en hardware real:
serial-mcp-server macro validate --file <paquete.json> --json
serial-mcp-server macro plan --file <paquete.json> --macro <nombre> --json
serial-mcp-server macro run --file <paquete.json> --macro <nombre> --simulate-read <respuesta> --json
serial-mcp-server macro run --file <paquete.json> --macro <nombre> --port <puerto> --baud 115200 --json

Los paquetes de macros son archivos DSL JSON restringidos. v0.3 soporta send, delay, expect contains, expect equals y ensambles que llaman macros. No soporta comandos de shell, ejecución de lenguajes, bucles, variables, comandos rápidos ni pasos de macro RTS/DTR.

Referencias

  • Lea references/cli.md para conocer el comportamiento exacto de los comandos, las expectativas de salida y las reglas de automatización.
  • Lea references/mcp.md cuando el usuario solicite configuración de MCP o uso de herramientas MCP.
  • Lea references/hardware-safety.md antes de cambiar la velocidad en baudios, el cableado, los niveles de voltaje, RTS, DTR o las líneas de reset/arranque.
  • Lea references/troubleshooting.md cuando un comando falle, se agote el tiempo de espera, no devuelva puertos o no pueda abrir el dispositivo.

Reportes

Reporte el comando, el estado de salida y el extracto relevante de JSON o error. Si no hay hardware conectado, limite el resumen de validación a las rutas de descubrimiento y ayuda.

Skills relacionados