Communitygithub.com

Adancurusul/serial-mcp-server

Rust MCP-Server und CLI für serielle/UART-Geräte mit JSON-Makroautomatisierung und Agenten-Fähigkeiten für wiederholbare zeitgesteuerte Arbeitsabläufe.

Was ist serial-mcp-server?

Dieses Skill bietet eine Rust-basierte MCP-Server- und CLI-Lösung für die Arbeit mit seriellen Schnittstellen (UART). Es ermöglicht die Geräteerkennung, das Senden und Empfangen von Daten sowie die Steuerung von RTS/DTR-Leitungen. Ein besonderes Merkmal ist die JSON-Makroautomatisierung, mit der sich wiederholbare, zeitgesteuerte Arbeitsabläufe definieren, validieren und ausführen lassen. Das Skill unterstützt primär die CLI-Nutzung, bietet aber auch MCP-Tools für die Integration in KI-Agenten wie Claude Code oder Cursor. Es richtet sich an Entwickler, die eingebettete Systeme oder Hardware über die serielle Schnittstelle debuggen und automatisieren möchten.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Serielles Debuggen

Betriebsregel

Verwenden Sie zuerst die serial-mcp-server CLI, es sei denn, der Benutzer fragt explizit nach MCP oder ein MCP-Client ist bereits konfiguriert. Halten Sie stdout-Daten von Diagnose getrennt, zitieren Sie genaue Befehle und basieren Sie den Hardware-Erfolg auf echten Befehlsergebnissen vom Gerät.

Arbeitsablauf

  1. Stellen Sie sicher, dass die Binärdatei verfügbar ist:
serial-mcp-server --help
  1. Listen Sie verfügbare Ports auf, bevor Sie ein Gerät auswählen:
serial-mcp-server list-ports --json
  1. Für einen Geräte-Smoke-Test testen Sie zuerst den Port, dann schreiben/lesen Sie nur, wenn der Test erfolgreich ist:
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. Wenn RTS oder DTR beteiligt ist, geben Sie die angeforderten Leitungspegel an und verwenden Sie den Befehl zur Steuerleitung:
serial-mcp-server set-control-lines --port <port> --rts high --dtr low --json
  1. Für wiederholbare serielle Prozeduren bevorzugen Sie JSON-Makropakete und validieren oder planen Sie diese vor der Ausführung auf echter Hardware:
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

Makropakete sind eingeschränkte JSON-DSL-Dateien. v0.3 unterstützt send, delay, expect contains, expect equals und Assemblies, die Makros aufrufen. Es werden keine Shell-Befehle, Sprachausführung, Schleifen, Variablen, Quick-Befehle oder RTS/DTR-Makroschritte unterstützt.

Referenzen

  • Lesen Sie references/cli.md für genaues Befehlverhalten, Ausgabeerwartungen und Automatisierungsregeln.
  • Lesen Sie references/mcp.md, wenn der Benutzer nach MCP-Einrichtung oder MCP-Toolnutzung fragt.
  • Lesen Sie references/hardware-safety.md, bevor Sie Baudrate, Verkabelung, Spannungspegel, RTS, DTR oder Reset-/Boot-Leitungen ändern.
  • Lesen Sie references/troubleshooting.md, wenn ein Befehl fehlschlägt, eine Zeitüberschreitung auftritt, keine Ports zurückgegeben werden oder das Gerät nicht geöffnet werden kann.

Berichterstattung

Melden Sie den Befehl, den Exit-Status und den relevanten JSON- oder Fehlerauszug. Wenn keine Hardware angeschlossen ist, beschränken Sie die Validierungszusammenfassung auf Erkennungs- und Hilfspfade.

Verwandte Skills