kerlenton/mcpsnoop

해결하는 문제

mcpsnoop는 Model Context Protocol (MCP)에 대한 투명한 프록시로, MCP용 'Wireshark'라고 할 수 있습니다. AI 클라이언트(예: Cursor, Claude Code, Codex 등)와 MCP 서버 간의 실제 통신 내용을 시각화할 수 있도록 해줍니다. 공식 MCP Inspector와 달리 자체 클라이언트로 작동하는 것이 아니라, 데이터 경로에 직접 위치하여 개발자가 모든 실제 도구 호출을 확인하고, 멈춘 호출을 식별하며, 잘못된 JSON-RPC 프레임을 탐지하고, 도구 정의의 차이를 발견할 수 있게 합니다.

작동 방식

이 도구는 단일 바이너리 내에서 두 가지 역할을 수행합니다: 투명한 쉘과 허브입니다. 쉘로 사용할 때(mcpsnoop -- <server>)는 클라이언트와 서버 사이의 바이트를 그대로 전달하면서 모든 프레임을 허브로 복사합니다. 허브(mcpsnoop에 인수 없이 실행)는 트래픽을 모니터링하고 분석할 수 있는 실시간 터미널 사용자 인터페이스(TUI)를 제공합니다. 두 구성 요소는 잘 알려진 소켓과 디스크 기반 로그를 통해 자동으로 연결됩니다. stdio 및 스트리밍 가능한 HTTP 서버를 모두 지원하며, GitHub Action을 통해 CI/CD 파이프라인에 통합되어 오류나 지연 예산을 초과할 경우 작업을 실패시킬 수 있습니다.

대상 사용자

AI 클라이언트 및 MCP 서버를 개발하거나 디버깅하는 개발자들로, JSON-RPC 트래픽과 도구 실행 성능에 대해 실시간이고 고해상도의 가시성을 필요로 하는 사람들입니다.

주요 기능

• 실시간 모니터링: 도구 호출과 JSON-RPC 프레임을 실시간으로 확인할 수 있는 실시간 TUI
• CI 통합: 게이트된 오류 발생 시 코드 스캔 경고를 생성하고 작업을 실패시키는 GitHub Action
• HTTP 프록시: 스트리밍 가능한 HTTP 서버를 지원하며, 상세한 HTTP 상태 추적 기능 제공
• 관측성: 도구 호출 총수, 오류율, 지연 시간 히스토그램에 대한 내장된 Prometheus 메트릭 제공
• 세션 관리: 분석을 위해 세션을 JSON, HTML, 텍스트, HAR, 또는 OTLP 형식으로 내보낼 수 있음
• 기밀 정보 마스킹: 공유 전에 로그에서 비밀번호, 키, 특정 경로를 제거할 수 있는 도구 제공
• 설정 없이 사용 가능: Claude Desktop 설정을 위한 간단한 wrap/unwrap 명령어 제공