Communitygithub.com

Adancurusul/serial-mcp-server

Servidor MCP e CLI em Rust para dispositivos serial/UART, com automação de macros JSON e habilidades de agente para fluxos de trabalho temporizados repetíveis.

O que é serial-mcp-server?

Esta skill fornece um servidor MCP (Model Context Protocol) e uma interface de linha de comando (CLI) em Rust para interagir com dispositivos seriais e UART. Ela permite que agentes de IA como Claude Code, Cursor ou Codex realizem operações de baixo nível em portas seriais, como listar portas, testar conexões, enviar comandos e ler respostas. A principal vantagem é a automação de fluxos de trabalho temporizados e repetíveis usando pacotes de macros JSON, que definem sequências de ações como envio de dados, delays e verificação de respostas. A skill suporta plataformas que implementam o protocolo MCP e também pode ser usada diretamente via CLI. Ela é projetada para depuração de hardware, testes de dispositivos e automação de procedimentos seriais complexos, sempre priorizando comandos exatos e evidências reais do dispositivo.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Depuração Serial

Regra de Operação

Use o CLI serial-mcp-server primeiro, a menos que o usuário solicite explicitamente o MCP ou um cliente MCP já esteja configurado. Mantenha os dados de stdout separados dos diagnósticos, cite comandos exatos e baseie o sucesso do hardware em evidências reais de comandos do dispositivo.

Fluxo de Trabalho

  1. Confirme que o binário está disponível:
serial-mcp-server --help
  1. Liste as portas disponíveis antes de escolher um dispositivo:
serial-mcp-server list-ports --json
  1. Para um teste rápido do dispositivo, primeiro teste a porta e depois escreva/leia apenas quando o teste for bem-sucedido:
serial-mcp-server probe --port <porta> --baud 115200 --json
serial-mcp-server write --port <porta> --baud 115200 --data H --read --timeout-ms 1000 --json
  1. Se RTS ou DTR estiverem envolvidos, informe os níveis de linha solicitados e use o comando de control-lines:
serial-mcp-server set-control-lines --port <porta> --rts high --dtr low --json
  1. Para procedimentos seriais repetíveis, prefira pacotes de macros JSON e valide ou planeje-os antes da execução em hardware real:
serial-mcp-server macro validate --file <pacote.json> --json
serial-mcp-server macro plan --file <pacote.json> --macro <nome> --json
serial-mcp-server macro run --file <pacote.json> --macro <nome> --simulate-read <resposta> --json
serial-mcp-server macro run --file <pacote.json> --macro <nome> --port <porta> --baud 115200 --json

Pacotes de macro são arquivos DSL JSON restritos. v0.3 suporta send, delay, expect contains, expect equals e montagens que chamam macros. Não suporta execução de shell, execução de linguagem, loops, variáveis, comandos rápidos ou etapas de macro RTS/DTR.

Referências

  • Leia references/cli.md para comportamento exato de comandos, expectativas de saída e regras de automação.
  • Leia references/mcp.md quando o usuário solicitar configuração MCP ou uso de ferramentas MCP.
  • Leia references/hardware-safety.md antes de alterar baud, cabeamento, níveis de tensão, RTS, DTR ou linhas de reset/boot.
  • Leia references/troubleshooting.md quando um comando falhar, expirar, não retornar portas ou não conseguir abrir o dispositivo.

Relatório

Relate o comando, o status de saída e o trecho relevante de JSON ou erro. Se nenhum hardware estiver conectado, limite o resumo de validação aos caminhos de descoberta e ajuda.

Habilidades Relacionadas