kerlenton/mcpsnoop

해결하는 문제

mcpsnoop은 "MCP용 Wireshark"로, AI 클라이언트(Cursor 또는 Claude Code 등)와 Model Context Protocol(MCP) 서버 간의 통신을 투명하게 모니터링하고 디버깅할 수 있도록 도와줍니다. 다른 인스펙터들이 자체 클라이언트로 작동하는 것과 달리, mcpsnoop은 데이터 경로에 직접 배치되어 실제 클라이언트가 전송하는 내용과 서버의 응답을 정확히 확인할 수 있습니다. 모델이 호출을 실패한 경우나 잘못된 인수를 가진 호출을 식별하는 데에도 유용합니다.

작동 방식

MCP 서버 명령을 감싸는 투명한 쉘로 작동합니다. 클라이언트와 서버 간의 바이트를 그대로 전달하면서 모든 JSON-RPC 프레임을 허브에 복사합니다. 이 허브는 실시간 모니터링을 위한 라이브 터미널 사용자 인터페이스(TUI)를 제공합니다. stdio 기반 서버와 스트리밍 HTTP 서버(역방향 프록시 역할)를 모두 지원하며, 구조화된 관측성을 위해 OpenTelemetry 스팬으로 데이터를 내보낼 수 있습니다.

대상 사용자

도구 호출, 지연 시간, 프로토콜 오류를 진단하기 위해 실제 와이어 레벨 통신을 확인해야 하는 MCP 서버나 AI 에이전트를 개발하거나 디버깅하는 개발자들.

주요 기능

• 투명한 모니터링: 클라이언트나 서버 코드를 변경하지 않고도 실제 데이터 경로에 배치 가능.
• CI/CD 통합: 오류, 유효하지 않은 프레임, 지연 시간 예산 초과 기반으로 빌드 실패를 유도하는 GitHub Action 포함.
• 관측성: OpenTelemetry로 내보내며, 도구 성능을 위한 실시간 Prometheus 메트릭 제공.
• 다양한 배포 지원: stdio 및 HTTP 서버를 지원하며, Claude Desktop 설정을 쉽게 래핑/언래핑할 수 있는 헬퍼 명령어 제공.
• 세션 관리: 캡처된 세션을 모킹하고, 두 세션을 비교하며, 과거 로그를 검토하여 사후 분석(Post-mortems)이 가능.