Communitygithub.com

Adancurusul/serial-mcp-server

Rust 기반 MCP 서버 및 CLI로 시리얼/UART 장치를 제어하며, JSON 매크로 자동화와 반복 가능한 시간 기반 워크플로우를 지원합니다.

serial-mcp-server란 무엇인가요?

이 스킬은 개발자와 AI 에이전트가 시리얼/uart 장치를 명령줄이나 MCP(MCP) 클라이언트를 통해 제어할 수 있도록 하는 Rust 기반 MCP 서버 및 CLI 도구입니다. 실제 하드웨어와의 상호작용 전에 매크로 팩(JSON DSL)을 사용하여 반복적인 시리얼 절차를 검증하고 계획할 수 있어 안전하고 예측 가능한 자동화가 가능합니다. 지원하는 플랫폼으로는 Cursor, Claude Code 등 MCP 프로토콜을 지원하는 모든 도구가 포함되며, CLI 모드에서는 독립적으로 사용할 수 있습니다. 또한 포트 탐색, 쓰기/읽기, RTS/DTR 제어, 매크로 검증/실행 등의 기능을 제공하며, `send`, `delay`, `expect` 등의 명령어로 구성된 매크로 DSL을 통해 복잡한 시리얼 워크플로우를 간결하게 자동화할 수 있습니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add Adancurusul/serial-mcp-server

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

시리얼 디버그

운영 규칙

사용자가 명시적으로 MCP를 요청하거나 MCP 클라이언트가 이미 설정되지 않은 경우, 먼저 serial-mcp-server CLI를 사용합니다. stdout 데이터는 진단 정보와 분리하고, 정확한 명령어를 인용하며, 하드웨어 성공 여부는 장비에서 나온 실제 명령 증거를 기준으로 합니다.

워크플로우

  1. 바이너리가 사용 가능한지 확인합니다:
serial-mcp-server --help
  1. 장치를 선택하기 전에 사용 가능한 포트를 나열합니다:
serial-mcp-server list-ports --json
  1. 장비 간단 테스트(smoke test)의 경우, 먼저 포트를 프로브(probe)한 후 프로브가 성공했을 때만 쓰기/읽기를 수행합니다:
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. RTS 또는 DTR이 관련된 경우, 요청된 라인 레벨을 명시하고 control-line 명령어를 사용합니다:
serial-mcp-server set-control-lines --port <port> --rts high --dtr low --json
  1. 반복 가능한 시리얼 절차의 경우, JSON 매크로 팩을 선호하며 실제 하드웨어 실행 전에 검증하거나 계획을 수립합니다:
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

매크로 팩은 제한된 JSON DSL 파일입니다. v0.3은 send, delay, expect contains, expect equals 및 매크로를 호출하는 어셈블리를 지원합니다. 셸 명령어, 언어 실행, 루프, 변수, Quick 명령어 또는 RTS/DTR 매크로 단계는 지원하지 않습니다.

참고 자료

  • 정확한 명령어 동작, 출력 예상 사항 및 자동화 규칙은 references/cli.md를 읽으세요.
  • 사용자가 MCP 설정이나 MCP 도구 사용을 요청할 때는 references/mcp.md를 읽으세요.
  • 보드(Baud), 배선, 전압 레벨, RTS, DTR 또는 리셋/부트 라인을 변경하기 전에 references/hardware-safety.md를 읽으세요.
  • 명령어가 실패하거나, 시간 초과되거나, 포트를 찾을 수 없거나, 장치를 열 수 없을 때는 references/troubleshooting.md를 읽으세요.

보고

명령어, 종료 상태, 관련 JSON 또는 오류 발췌문을 보고하세요. 하드웨어가 연결되지 않은 경우, 검증 요약을 포트 검색 및 도움말 경로로 제한합니다.

관련 스킬