mcpsnoop

MCP 구간을 그대로 들여다보는 투명 프록시

brew install mcpsnoop

쓰는 클라이언트와 MCP 서버 사이에 끼어 오가는 모든 호출을 터미널에 실시간으로 보여 줍니다. 공식 점검 도구는 자기가 클라이언트가 되어 붙기 때문에 실제 클라이언트가 무엇을 보냈는지는 보지 못합니다. 그래서 모델이 아예 부르지 않은 호출이나 인자를 잘못 넣은 호출은 잡히지 않습니다. 이쪽은 실제 데이터 경로에 앉아서 그 차이를 드러냅니다. 서버 실행 명령 앞에 붙이기만 하면 되고, 클로드 데스크톱은 설정을 대신 고쳐 주는 명령까지 있습니다. 기록한 세션을 CI 에서 검사하는 깃허브 액션도 같은 저장소가 제공합니다.

판단

이럴 때 씁니다

  • 도구가 호출되지 않는 이유를 모를 때
  • 인자가 이상하게 들어가는지 확인해야 할 때
  • 호출이 멈춰 있는 구간을 잡아야 할 때

이럴 땐 쓰지 마세요

  • 서버 코드를 고치는 도구가 아닙니다
  • 클라이언트를 안 거치는 단독 시험에는 공식 점검 도구가 낫습니다
  • 표준 입출력이 아닌 연결 방식은 확인이 필요합니다

차별점

  • 실제 클라이언트와 서버 사이 데이터 경로에 앉습니다.
  • 모델이 아예 부르지 않은 호출까지 드러납니다.
  • 설정 파일을 대신 고쳐 주고 되돌립니다.
  • 기록한 세션을 CI 에서 검사하는 깃허브 액션을 함께 제공합니다.

워크플로

  1. 01시연 명령으로 화면을 먼저 봅니다.
  2. 02클라이언트 설정에서 서버 실행 명령 앞에 붙입니다.
  3. 03클라이언트를 다시 켭니다.
  4. 04실제로 쓰면서 오가는 호출을 봅니다.
  5. 05필요하면 세션을 저장해 CI 에서 검사합니다.

주요 명령

명령설명
brew install mcpsnoop설치합니다. 고 설치나 전역 npm 설치도 됩니다.
mcpsnoop demo설정 없이 화면을 먼저 봅니다.
mcpsnoop wrap my-server클로드 데스크톱 설정을 대신 고쳐 그 서버만 경유시킵니다.
mcpsnoop unwrap my-server원래대로 되돌립니다.

함정

설치 전에 확인하세요

  • MCP 서버는 시작할 때 한 번만 실행됩니다. 감싸거나 되돌린 뒤에는 클라이언트를 다시 켜야 합니다.
  • 설정을 고치는 명령은 처음 한 번 백업을 만들고 해당 항목만 바꿉니다. 다른 서버 설정은 건드리지 않습니다.
  • 매번 내려받지 않으려면 전역으로 깔라고 안내합니다. 임시 실행만 반복하면 느립니다.
  • 공식 점검 도구와 목적이 다릅니다. 서버 단독 시험은 그쪽이 맞습니다.

비교

공식 점검 도구는 스스로 클라이언트가 되어 붙기 때문에 실제 클라이언트가 무엇을 보냈는지 못 봅니다. 요청이 오기를 기다리는 방식은 안 온 요청을 보여 주지 못합니다. 이쪽은 그 사각지대를 겨냥한 도구라 목적이 다릅니다.

최근 변경

기록한 세션을 워크플로에서 세 줄로 검사하는 깃허브 액션이 들어갔습니다. 사전 배포 태그가 최신 판으로 잡히지 않게 하는 수정도 함께 나왔습니다.

공식 변경 내역