Communitygithub.com

Adancurusul/serial-mcp-server

Serveur MCP en Rust et CLI pour périphériques série/UART, avec automatisation JSON par macros et compétences agent pour workflows temporisés répétables.

Qu'est-ce que serial-mcp-server ?

Ce skill fournit un serveur MCP (Model Context Protocol) et une interface en ligne de commande (CLI) pour interagir avec des périphériques série/UART. Il est utile pour les développeurs et agents IA qui automatisent la communication avec du matériel série, comme des microcontrôleurs ou des capteurs, en utilisant un ensemble structuré de commandes et de macros JSON. Initialement conçu pour les environnements Rust, il fonctionne via le binaire `serial-mcp-server` et prend en charge les commandes pour lister les ports, sonder (probe), écrire/lire des données, et gérer les lignes de contrôle (RTS/DTR). La version 0.3 introduit un format de pack de macros JSON permettant des séquences répétables incluant `send`, `delay`, et des assertions `expect`. L'agent suit un workflow clair : vérifier la disponibilité du binaire, lister les ports, puis effectuer des tests de validation matérielle avec sortie JSON. Les macros permettent de planifier et d'exécuter des scripts sans support shell, boucles ou variables, garantissant des tests précis et reproductibles.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Debug série

Règle d'utilisation

Utilisez d'abord la CLI serial-mcp-server, sauf si l'utilisateur demande explicitement MCP ou qu'un client MCP est déjà configuré. Séparez les données stdout des diagnostics, citez les commandes exactes et basez la réussite matérielle sur des preuves de commandes réelles provenant du périphérique.

Workflow

  1. Confirmez que le binaire est disponible :
serial-mcp-server --help
  1. Listez les ports disponibles avant de choisir un périphérique :
serial-mcp-server list-ports --json
  1. Pour un test de validation du périphérique, sondez d'abord le port, puis écrivez/lisez uniquement lorsque la sonde réussit :
serial-mcp-server probe --port <port> --baud 115200 --json
serial-mcp-server write --port <port> --baud 115200 --data H --read --timeout-ms 1000 --json
  1. Si RTS ou DTR est impliqué, indiquez les niveaux de ligne demandés et utilisez la commande de contrôle des lignes :
serial-mcp-server set-control-lines --port <port> --rts high --dtr low --json
  1. Pour les procédures série répétables, privilégiez les packs de macros JSON et validez ou planifiez-les avant l'exécution sur du matériel réel :
serial-mcp-server macro validate --file <pack.json> --json
serial-mcp-server macro plan --file <pack.json> --macro <name> --json
serial-mcp-server macro run --file <pack.json> --macro <name> --simulate-read <response> --json
serial-mcp-server macro run --file <pack.json> --macro <name> --port <port> --baud 115200 --json

Les packs de macros sont des fichiers DSL JSON restreints. v0.3 prend en charge send, delay, expect contains, expect equals et les assemblages qui appellent des macros. Il ne prend pas en charge les commandes shell, l'exécution de langage, les boucles, les variables, les commandes rapides (Quick commands) ni les étapes de macro RTS/DTR.

Références

  • Lisez references/cli.md pour le comportement exact des commandes, les attentes en sortie et les règles d'automatisation.
  • Lisez references/mcp.md lorsque l'utilisateur demande une configuration MCP ou l'utilisation d'outils MCP.
  • Lisez references/hardware-safety.md avant de changer le baud, les connexions, les niveaux de tension, RTS, DTR, ou les lignes de reset/boot.
  • Lisez references/troubleshooting.md lorsqu'une commande échoue, expire, ne renvoie aucun port, ou ne peut pas ouvrir le périphérique.

Rapport

Signalez la commande, l'état de sortie et l'extrait JSON ou d'erreur pertinent. Si aucun matériel n'est connecté, limitez le résumé de validation aux chemins de découverte et d'aide.

Skills associés