mcpsnoop

MCP용 Wireshark. AI 클라이언트와 MCP 서버 사이의 모든 실제 도구 호출을 터미널에서 실시간으로 보여주는 투명 프록시입니다.

mcpsnoop demo

문제점

공식 MCP Inspector는 자체 클라이언트로 연결되므로 사용자의 클라이언트(Cursor, Claude Code, Codex)가 서버에 실제로 보내는 내용을 볼 수 없습니다. 또한 요청이 도착하기를 기다리는 방식은 모델이 호출하지 않았거나 잘못된 인수로 호출한 경우를 표시할 수 없습니다. 도구가 조용히 호출되지 않거나, 기능이 일치하지 않거나, 호출이 그냥 멈추는 경우 로그를 뒤지고 추측할 수밖에 없습니다.

mcpsnoop는 대신 실제 데이터 경로에 위치합니다. 서버 명령을 mcpsnoop로 감싸면 실제 클라이언트와 서버가 통신하는 동안 모든 JSON-RPC 프레임을 실시간으로 볼 수 있습니다.

CI에서

`redact-key`, `redact-value`, `redact-path`를 각각 별도의 줄에 반복해서 입력하면 각 항목을 여러 개 추가할 수 있습니다. 이것이 지원하는 키의 전부입니다. 이 파일은 현재 작업 디렉터리에서만 조회되며, 상위 디렉터리에서는 조회되지 않습니다. 명시적인 명령줄 플래그는 구성 파일의 값을 덮어씁니다. ## 명령어 | 명령어 | 기능 | |---|---| | `mcpsnoop -- <server>` | stdio 서버를 투명한 셔임(shim)으로 감싸기 | | `mcpsnoop` | 실시간 TUI 열기 | | `mcpsnoop http --target <url>` | streamable-HTTP 서버 프록시 | | `mcpsnoop export` | 세션을 json, html, text, har 또는 otlp로 렌더링 | | `mcpsnoop check` | 오류, 잘못된 프레임, 경고, 라우팅 불일치, 응답 없는 호출, 지연된 결과 또는 지연 시간 예산에 대해 CI 실패 처리 | | `mcpsnoop baseline` | 신뢰할 수 있는 도구 정의 검사, 수락 또는 재설정 | | `mcpsnoop diff` | 두 캡처 세션 간 도구 및 호출 비교 | | `mcpsnoop open` | TUI에서 저장된 세션 열기 | | `mcpsnoop inventory` | 이 머신에서 mcpsnoop을 통해 실행된 모든 서버 나열 | | `mcpsnoop stats` | 저장된 모든 캡처를 서버 및 도구별로 한 행씩 접기 | | `mcpsnoop prune` | 특정 기준일보다 오래된 저장된 세션 로그 삭제 | | `mcpsnoop wrap <server>` | Claude Desktop의 서버 중 하나를 mcpsnoop을 통해 라우팅 | | `mcpsnoop unwrap <server>` | 해당 서버의 항목을 원래 상태로 되돌리기 | | `mcpsnoop remote <user@host>` | SSH 터널 명령 출력 | | `mcpsnoop demo` | 스크립트된 세션 재생 | 전체 목록은 `mcpsnoop help`를, 특정 명령의 플래그는 `mcpsnoop help <command>`를 실행하세요. ## 비교 | | MCP Inspector | mcpsnoop | |---|:---:|:---:| | 실제 클라이언트 및 서버 트래픽을 볼 수 있음 | 아니요 | 예 | | 응답 없는 호출 및 스트림 오류 플래그 | 아니요 | 예 | | 스트림을 손상시키는 불필요한 출력 플래그 | 아니요 | 예 | | 잘못된 JSON-RPC 프레임 플래그 | 아니요 | 예 | | 승인 후 도구 정의 변경 감지 | 아니요 | 예 | | 대화형 터미널 UI | 아니요 | 예 | | 구성 불필요, 플래그나 순서 없음 | 아니요 | 예 | | 기능 검사기 | 부분적 | 예 | | 캡처된 호출 재생 | 아니요 | 예, stdio 및 HTTP를 통해 | | 세션 내보내기 (json / html / text / otlp) | 아니요 | 예 | | 단일 바이너리, 런타임 종속성 없음 | 아니요 | 예 | ## 설치 ### npm Go 툴체인이 필요 없습니다. 대부분의 MCP 서버는 Node 또는 Python으로 작성되므로 이것이 가장 빠른 방법입니다.```bash npx mcpsnoop -- node build/index.js

`--older-than`는 필수입니다(아무것도 삭제하지 않는 기본값은 없습니다) 그리고 `30d` 같은 일 수 또는 `72h` 같은 Go duration을 허용합니다. 도구 기준선은 그대로 두는데, 기준선은 세션이 아닌 서버 라벨로 키가 지정되기 때문입니다. Inspector처럼 옆에 있는 것이 아니라 실제 파이프 안에 있기 때문에 실제 클라이언트와 서버가 서로 주고받는 내용을 정확히 볼 수 있으며, 서버가 어떤 언어로 작성되었든 관계없습니다. ## 키 바인딩 | 키 | 동작 | | 키 | 동작 | |---|---|---|---|---| | `enter` | 검사 / 드릴다운 | | `/` | 필터 | | `esc` | 뒤로 | | `:` | 명령 | | `j` / `k` | 이동 | | `r` / `R` | 재생 / 편집 후 재생 | | `g` / `G` | 맨 위 / 맨 아래 | | `c` | 기능(capabilities) | | `ctrl-f` / `ctrl-b` | 페이지 | | `s` | 도구 요약 | | `p` | 일시정지 | | `y` | 복사 | | `shift`+`<키>` | 열 기준 정렬 | | `e` | 내보내기 | | `ctrl-d` | 세션 삭제 | | `f` | 따라가기 | | `?` | 도움말 | | | | 앱에서 `?`를 누르면 전체 목록을 볼 수 있습니다. ## 스트림 필터링 세션에서 `/`를 누르고 공백으로 구분된 토큰을 AND 조건으로 결합합니다. 일반 텍스트는 메서드, 도구, id, 페이로드와 일치합니다. | 토큰 | 필터 기준 | 예시 | |---|---|---| | `tool:` | 도구 이름 | `tool:search` | | `method:` | JSON-RPC 메서드 | `method:tools/call` | | `id:` | 요청 id 및 이를 이어가는 모든 재시도 | `id:7` | | `task:` | 작업 id | `task:01J...` | | `dir:` | 방향 (`c2s`, `s2c`) | `dir:s2c` | | `kind:` | 프레임 유형 (`req`, `resp`, `notify`, `stderr`, `invalid`) | `kind:invalid` | | `status:` | 호출 결과 (`ok`, `error`, `cancel`, `late`, `cancelled`, `pending`, `bad`, `warn`, `mismatch`, 또는 `401` 같은 HTTP 상태) | `status:error` | 토큰을 쌓아서 더 구체적으로 필터링하세요.```text tool:search status:pending # in-flight calls to one search tool status:cancel # calls the client gave up on (status:cancelled is a cancelled task) status:late # results that arrived after the cancellation method:tools/call status:error # tool calls that failed dir:s2c kind:req # server-initiated requests (servers before 2026-07-28)

이 플래그들은 내보낸 파일이나 메모리 내 TUI 뷰를 다시 작성하며, 소스 JSONL은 절대 건드리지 않습니다. `export`는 입력과 같은 파일 이름을 출력으로 지정하는 것을 거부하며, 임시 파일을 통해 작성한 뒤 이름을 바꿔 제자리에 넣으므로, 실행이 실패해도 이전 파일은 온전하게 남습니다. 도구의 `inputSchema`와 `outputSchema`는 `tools/list` 결과에 광고된 대로, `--redact-key`와 `--redact-secrets`의 영향을 받지 않습니다. 그 이유는 세 가지입니다. - 스키마 안의 이름은 값이 아니라 타입 선언입니다. - 그 이름 자체는 어느 쪽이든 로그에 남습니다. - `token`이라는 속성 아래의 하위 스키마를 지우면 도구 자체의 검사도 함께 사라집니다. 예외는 바로 그 위치뿐이므로, 우연히 `inputSchema`라고 불리는 인자는 다른 인자와 마찬가지로 지워지며, 데이터가 아닌 구조를 담는 `default`, `const`, `examples`, `enum`에서 중단됩니다. `--redact-path`를 사용해 스키마 내부의 무언가를 지정하거나, `--redact-value`를 사용하세요. 이는 mcpsnoop이 파싱하는 두 키워드인 `type`과 `x-mcp-header`를 제외한 어디에 있든 텍스트와 일치합니다. 각 플래그가 도달하는 범위는 서로 다르므로, 가정하지 말고 결과를 확인하세요. 네 가지 모두 JSON-RPC 페이로드를 지우며, `--redact-key`, `--redact-path`, `--redact-secrets`는 오직 그것들에만 도달합니다. `--redact-value`만이 stderr, 기타 비-JSON 텍스트, 그리고 문자열 내부까지도 지웁니다. `Mcp-Param-*` 헤더는 그것이 반영하는 본문 값과 함께 지워집니다. 나머지 봉투 메타데이터, 서버 라벨, `Mcp-Name`, `Mcp-Method`, HTTP 상태는 캡처된 그대로 남습니다. 편집은 최선의 노력으로 수행되므로, 별도의 출력 경로를 사용하고 공유하기 전에 결과를 읽어보세요. ### 스트림 완료 호출을 OTLP 수집기로 전송 프록시가 실행되는 동안 OTLP/HTTP JSON 트레이스 엔드포인트를 가리켜 스팬을 전송하세요. 수집기 인증 또는 테넌트 헤더를 위해 `--otlp-header`를 반복하세요.```bash mcpsnoop \ --otlp-endpoint http://localhost:4318/v1/traces \ --otlp-header "Authorization=Bearer $OTLP_TOKEN" \ -- node build/index.js mcpsnoop http \ --target http://localhost:3000/mcp \ --otlp-endpoint http://localhost:4318/v1/traces

릴리스를 고정하세요. 원하는 버전이면 됩니다. 최신 버전은 [릴리스 페이지](https://github.com/kerlenton/mcpsnoop/releases)에 있습니다. 의도적으로 떠다니는 `v1`은 없습니다. 고정된 릴리스는 액션이 설치하는 바이너리이기도 하므로, 둘이 어긋날 수 없고, 낡아버릴 버전 기본값도 없습니다. | 입력 | | |---|---| | `session` | 확인할 `.jsonl` 캡처 파일. 저장소 루트 기준 상대 경로. 필수 | | `fail-on` | `--fail-on`과 동일. CLI 기본값과 동일한 값으로 기본 설정됨 | | `args` | 명령줄에서 따옴표로 묶은 기타 `check` 플래그. 액션이 리포트를 읽으므로 `--format`은 거부됨 | | `upload-sarif` | 리포트를 코드 스캐닝으로 전송. `true` | | `category` | 코드 스캐닝 네임스페이스. `mcpsnoop`. 매트릭스의 각 레그마다 다르게 지정하세요. 그렇지 않으면 레그들이 서로 덮어씁니다 | | `fail-on-findings` | 발견 사항이 있으면 작업을 실패 처리. `true`. `false`로 설정하면 알림을 등록하고 코드 스캐닝의 필수 검사가 결정하도록 둡니다 | | `version` | 설치할 mcpsnoop 버전. 고정한 릴리스로 기본 설정됨 | | `install` | mcpsnoop가 이미 PATH에 있으면 `false`. 릴리스가 빌드되지 않은 플랫폼에서 사용하는 방식입니다 | 출력은 `outcome`, `sarif`, `exit-code`입니다. `outcome`은 `passed`, `findings`, 또는 `error`이며, 세 번째는 별도로 처리할 가치가 있습니다. 이는 아무것도 검사되지 않았음을 의미하며, 아무것도 발견되지 않은 것과는 다릅니다. **검사를 수행할 수 없는 실행은 `fail-on-findings` 값과 관계없이 작업을 실패 처리합니다**. 왜냐하면 아무것도 검증하지 않고 초록불이 켜지는 파이프라인은 실패하는 것보다 더 나쁘기 때문입니다. 작업에는 `security-events: write` 권한이 필요합니다. 그렇지 않으면 업로드가 403을 반환합니다. 코드 스캐닝이 없는 저장소에서는 `upload-sarif: false`로 설정하세요. ### 직접 연결하기 이 액션은 네 단계로 이루어져 있으며 마법은 없습니다. 수동으로 수행하려면 그만큼의 주의가 필요합니다. 업로드는 리포트가 있는 실행에서 실행되어야 하며, 이는 종료 코드 0 또는 1로 종료된 실행이고 종료 코드 2로 종료된 실행은 아닙니다. 그리고 작업을 실패 처리하는 단계는 그 뒤에 와야 합니다. 그렇지 않으면 발견 사항이 존재 목적인 탭에 도달하지 못합니다.```yaml permissions: # required for all workflows security-events: write # only required for workflows in private repositories actions: read contents: read steps: - name: Check captured MCP session id: check run: | code=0 mcpsnoop check --format sarif artifacts/session.jsonl > mcpsnoop.sarif || code=$? echo "exit-code=$code" >> "$GITHUB_OUTPUT" # 2 means the check never happened, so there is no report to publish and # nothing was verified. Stop here rather than uploading an empty file. [ "$code" -le 1 ] || exit 1 - name: Upload mcpsnoop SARIF report if: ${{ !cancelled() }} uses: github/codeql-action/upload-sarif@v4 with: sarif_file: mcpsnoop.sarif category: mcpsnoop - name: Fail on findings # Separate, and after the upload, so the findings reach the Security tab on # exactly the runs that have some. if: ${{ !cancelled() && steps.check.outputs.exit-code == '1' }} run: exit 1

`drift`와 마찬가지로 `deprecated`는 옵트인(opt-in) 방식입니다. 기본 실행에서는 개수만 보고하고 녹색으로 유지되므로, 아직 합법적인 deprecated 기능을 사용하는 세션은 그 자체로 CI를 빨간색으로 만들지 않습니다. ### 클라이언트가 처리에 어려움을 겪는 플래그 스키마 구조 서버가 완전히 유효하더라도 에이전트가 사용하기 어려울 수 있습니다. 클라이언트마다 JSON Schema를 실제로 지원하는 정도가 다르며, 모델이 계속 잘못 호출하는 도구는 종종 스키마가 클라이언트가 제공하는 것보다 더 많은 것을 요구한 경우입니다. `s`로 여는 도구 요약에는 SCHEMA 열이 있으며, 각 광고된 도구의 스키마에서 가장 눈에 띄는 특징을 표시하고, 종류가 두 개 이상이면 끝에 `+`를 붙입니다. | 표시 | 의미 | |---|---| | `no root` | `inputSchema`가 없거나, JSON 객체가 아니거나, 루트 유형이 `"object"`가 아님 | | `dialect` | 개정판이 기본값으로 사용하는 2020-12가 아닌 다른 방언을 지정하는 `$schema` | | `ext ref` | 문서 외부를 가리키는 `$ref`로, 사양이 구현자에게 맹목적으로 따르지 말라고 경고하는 경우이기도 함 | | `oneOf`, `anyOf`, `allOf`, `not` | 클라이언트마다 일관되지 않게 처리되는 합성(composition) 키워드 | | `ref` | 같은 문서 내부를 가리키는 `$ref` | | `untyped` | 유형을 선언하지 않고 수용 대상을 설명하는 다른 방법도 없는 속성 | 첫 번째를 제외한 모든 항목은 판정이 아닌 관찰입니다. `oneOf`를 사용하는 스키마는 잘못된 것이 아니라 클라이언트마다 다르게 읽힐 가능성이 높을 뿐이며, 스키마는 원하는 방언을 선언할 수 있습니다. `no root`는 예외입니다. `Tool` 정의는 `inputSchema`를 요구하고 루트 유형을 `"object"`로 고정하므로, 목록을 검증하는 클라이언트는 해당 도구를 완전히 거부하고 호출 가능 상태가 되지 않으며, 그 이유를 설명하는 내용이 통신선에 실리지 않습니다. `no root`가 열의 맨 앞에 오는 이유가 바로 이것이며, mcpsnoop 자체의 편집(redaction)이 지운 스키마는 보고되지 않습니다. 읽을 수 없는 스키마는 잘못된 스키마가 아니기 때문입니다. 이 구분이 `check`가 이들을 처리하는 방식을 결정합니다. `no root`는 `tools/list` 프레임에 대한 경고이므로, 플래그 없이도 기본 `error,invalid,warn` 게이트를 실패시킵니다. 이것이 핵심입니다. 사용할 수 없는 도구를 제공하는 서버는 모든 핸드셰이크에 정상적으로 응답하고 단순히 `tools/call`을 받지 않을 뿐입니다. 관찰 항목은 `schema_findings`로 집계되어 `schema findings:` 아래에 보고되며, `--fail-on`에 `schema`를 추가할 때만 실행을 실패시킵니다. 둘 다 `--format junit`과 `--format sarif`에 도달하며, `export`는 `summary.definitions.per_tool[].findings` 아래에 도구별 목록을 전달합니다.```bash mcpsnoop check session.jsonl # a non-object root already fails this mcpsnoop check --fail-on schema session.jsonl # and now so do the observations

`--replay-target` 없이 HTTP 세션은 작동할 수 없는 키를 제공하는 대신 그렇게 말합니다. 키가 있으면 `r`은 세션의 첫 전송 전에 여전히 물어보며, 기록된 명령이 실행되기 전에 답변을 받는 것과 같은 방식입니다. 자격 증명은 `--replay-header`를 통해서만 서버에 도달하며 다른 경로는 없습니다. mcpsnoop는 `Authorization` 헤더를 기록하지도 재생하지도 않으므로, 재생이 유출할 수 있는 캡처된 내용이 없습니다. 재생된 POST는 전송이 필수로 만드는 것을 담고 있으며, 캡처된 본문만으로는 담지 못하는 것들입니다: `MCP-Protocol-Version`, `application/json`과 `text/event-stream`을 모두 나열하는 `Accept`, `Mcp-Method`, 사양이 요구하는 경우 `Mcp-Name`, 그리고 캡처된 모든 `Mcp-Param-*`. 이들은 캡처에서 그대로 재전송되며, base64 센티널까지 포함하므로, 재파생이 할 수 있는 것처럼 본문과 불일치할 수 없습니다. 복사되지 않는 유일한 헤더는 프로토콜 버전인데, 재생된 본문이 mcpsnoop가 사용하는 개정판을 선언하고 헤더가 본문과 일치해야 하기 때문입니다. `Mcp-Name`은 복사되는 대신 전송되는 본문에서 파생되는데, 사양이 이를 `params.name` 또는 `params.uri`에서 가져오고 서버가 본문과 불일치하는 헤더를 거부하도록 요구하므로, 도구 이름을 바꾸는 편집은 그렇지 않으면 이전 이름을 보내게 됩니다. `Mcp-Param-*` 헤더는 캡처된 인수를 반영하므로, 편집된 재생은 누군가 다시 작성한 본문에 대해 주장하는 대신 아무것도 보내지 않습니다. 캡처는 해당 계열의 헤더만 설정할 수 있습니다. 로그는 사람들이 주고받는 파일이며, 임의의 헤더를 지정하도록 허용하면 필수 헤더를 덮어쓰거나 아무도 전달하지 않은 자격 증명을 추가할 수 있습니다. 교정 규칙이 지운 `Mcp-Param-*`는 이유와 함께 재생을 중지합니다. 플레이스홀더를 보내면 mcpsnoop 자체의 바이트가 사용자가 입력한 것처럼 라이브 서버에 전달됩니다. 리다이렉트는 따르지 않고 거부됩니다. 주소는 사용자가 지정하고 답변한 것이며, 307을 따르면 그 선택이 원격 측에 넘어가 본문을 다시 보내고, 포트만 변경하는 홉에서는 자격 증명도 다시 보냅니다. mcpsnoop는 서버가 보내려던 위치를 보고하고, 대신 그 주소를 지정할지 여부를 사용자가 결정하게 합니다. 단일 JSON 객체로 도착하는 답변과 이벤트 스트림으로 도착하는 답변은 모두 읽히며, 실패는 번호가 아닌 이름으로 보고됩니다: - 401은 서버가 요구한 스킴을 보고합니다 - `-32020`은 서버가 이의를 제기한 내용을 보고합니다 - JSON-RPC가 아닌 400 또는 404는 해당 주소가 이 개정판의 Streamable HTTP 엔드포인트가 아님을 말합니다 ### 서버의 지연 시간을 사용자의 것과 구분하기 다중 왕복 요청에서 하나의 도구 호출은 여러 요청이며, 사람이 일러두기에 답변하는 데 쓴 초는 그 범위 안에 있습니다. 이는 의도적인데, 그 간격이 보통 가장 보고 싶은 것이기 때문이지만, 하나의 숫자로 두 질문에 모두 답할 수는 없음을 의미합니다. 서버가 1.2초 동안 작업하고 사용자가 37초를 쓴 `book_flight` 체인에서 `check --max-duration 5s`는 도구가 38.2초를 쓴 것으로 비난합니다. 여전히 그렇게 하는데, 그 플래그의 의미를 바꾸면 이미 설정한 모든 파이프라인이 느슨해지기 때문입니다. 두 형제 플래그는 대신 측정하는 것을 이름으로 지정합니다.```bash mcpsnoop check --max-server-duration 1s session.jsonl # the server's share alone mcpsnoop check --max-round-trips 2 session.jsonl # how chatty a tool is

둘 다 기본적으로 꺼져 있어서 기본 `check` 실행에는 영향을 주지 않으며, 둘 다 프레임 타임스탬프와 mcpsnoop가 이미 추론한 링크에서 읽어오므로 의도를 추측하지 않습니다. TUI에서 `i`를 누르면 세부 내역을 볼 수 있고, json, text, html 내보내기에서 `interactions`를 읽을 수도 있습니다. 각 항목은 하나의 논리적 작업으로, 왕복 횟수, 총 시간, 서버가 보유한 비율, 클라이언트를 기다린 비율을 포함하며, 각 홉에 대해 각 응답이 무엇을 요청했는지 알려주는 줄이 있습니다. 도구별 요약에는 `TRIPS` 열이 추가되어 아무것도 열지 않아도 말이 많은 도구를 확인할 수 있습니다. `export --format har`는 서버의 비율을 `wait`에, 나머지를 `blocked`에 넣는데, 이는 해당 필드의 용도이므로 뷰어가 실제로 발생하지 않은 38초 서버 대기를 그리지 않게 됩니다. 횟수와 두 비율은 요청 시 파생되는 것이 아니라 프레임이 도착할 때 누적됩니다. 라이브 저장소는 예산 안에 머물기 위해 오래된 프레임을 해제하므로, 파생된 답변은 조용히 체인이 아닌 창(window)이 되기 때문입니다. 홉별 세부 내역은 여전히 보유 중인 프레임에서 읽어오며, 일부만 포함된 경우 그렇게 명시합니다. `ServerTime + ClientTurnaround`는 누구도 신뢰해야 하는 산술이 아니라 구조적으로 총 시간과 같습니다. `--max-round-trips`는 아직 실행 중인 체인을 판단합니다. 이미 만든 모든 요청은 셀 수 있고, 서버가 계속해서 다시 요청하면 정확히 아무도 끝내지 못하는 작업이 생성되기 때문입니다. `--max-server-duration`은 종료를 기다리는데, 이는 `--max-duration`이 이미 적용하는 규칙입니다. 아직 열려 있는 작업은 판단할 대기 시간이 없기 때문입니다. mcpsnoop가 연결할 수 없었던 작업은 자체 단일 홉 항목으로 유지됩니다. `matchRetry`는 의도적으로 모호한 링크를 거부하며, 이 보기는 그 공백을 메우지 않습니다. 요청 하나만 걸린 작업은 홉별 세부 내역을 포함하지 않습니다. 단일 홉은 위의 총 시간을 그대로 반복하기 때문입니다. 체인은 요청당 하나의 홉을 보고하며, 저장소가 더 이상 모든 프레임을 보유하지 않거나 작업이 홉을 구성하는 요청-응답 쌍 밖에서 처리되었을 때(작업 핸들이 그런 경우) 그렇게 명시합니다. ### 서버가 사용자에게 무엇을 요청했는지 확인 Elicitation은 MCP에서 사람이 서버에 데이터를 입력하는 유일한 경로이며, MRTR에서는 질문과 답변이 더 이상 하나의 교환의 두 절반이 아닙니다. 질문은 `InputRequiredResult`에 묻혀 있고, 답변은 다른 id의 재시도에서 `inputResponses` 안으로 돌아오며, 둘을 묶는 유일한 것은 mcpsnoop가 이미 추론한 링크입니다. 그 연결이 없으면 거부된 비밀번호 요청은 평범한 도구 오류로 읽힙니다.``` tools/call login_legacy [form] creds: decline after 3s password string

# 4.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.``` read 16 logs of 16 in ~/.local/state/mcpsnoop/sessions SERVER TOOL CALLS ERR PROTO FAIL% SESS p50 p95 p99 DEF flaky-demo run_query 13 3 0 23.1% 3/13 434ms 519ms 519ms 195B docs-mirror run_query 3 1 0 33.3% 1/3 357ms 434ms 434ms 195B docs-mirror search_docs 12 0 0 0.0% 0/3 377ms 386ms 386ms 200B flaky-demo search_docs 52 0 0 0.0% 0/13 42ms 58ms 59ms 200B

서버별로 세션이 아니라 행 하나가 서버 하나에 대응한다. 행 키는 레이블이 아니라 기록된 명령과 작업 디렉터리다. 레이블은 명령의 마지막 경로 요소에서 유래하며, `node ~/one/build/index.js`와 `node ~/two/build/index.js`는 둘 다 `index.js`를 도출하기 때문이다. HTTP 세션은 mcpsnoop이 그곳에서 아무것도 실행하지 않았으므로 대신 프록시한 엔드포인트를 키로 사용한다. 읽기는 로그 하나당 봉투 하나, 즉 프록시가 먼저 쓰는 메타 프레임이므로 대용량 캡처 디렉터리에서도 비용이 낮게 유지된다. `--tools`는 예외로 서버당 로그 하나, 즉 각 서버의 가장 최근 실행을 읽는데, 그래서 열이 아니라 플래그인 것이다. 그 경우에도 읽기는 제한적이다. 도구 인벤토리는 저장소가 진행하면서 접어 넣는 세션 상태이므로, 수백 메가바이트 캡처는 정수 하나를 만들기 위해 전체를 메모리에 담지 않고 고정 창을 통해 읽힌다. 개수가 없을 때 행은 세 가지 상황 중 어떤 것이 발생했는지를 말한다. 읽을 수 없는 로그는 아무것도 광고하지 않은 서버가 아니며, 둘을 한 문장으로 처리하면 mcpsnoop이 거짓된 내용을 진술하게 되기 때문이다. `--redact` 규칙이 다시 쓴 명령은 기록된 대로 출력되고 표시되며, 실제 실행된 명령인 것처럼 넘겨지지 않는다. 한 서버의 두 실행, 하나는 정리되고 하나는 정리되지 않은 경우는 두 개의 행이 된다. mcpsnoop은 자리표시자가 무엇을 대체했는지 알 수 없으며, 병합하면 숨겨진 절반이 일치했다고 추측하는 셈이 된다. 두 개의 `--label` 값 아래에서 실행된 한 서버는 두 이름을 모두 담은 하나의 행이 된다. 키가 이름이 아니라 명령이기 때문이다. 행의 어떤 것도 mcpsnoop이 작성하지 않는다. 명령은 서버를 설치한 사람에게서 오고, 작업 디렉터리는 파일시스템에서 나오며, 파생 레이블은 명령에서 나온다. 제어 문자를 담은 값은 원시로 출력되지 않고 따옴표로 처리되므로, 이름에 개행이 포함된 디렉터리가 출력되는 필드를 닫아버려 다음 줄들이 실행된 적 없는 서버로 읽히는 일이 없다. 공백을 포함한 인수도 따옴표로 처리된다. `node "~/My Project/build/index.js"`는 그렇지 않으면 두 인수와 구분할 수 없기 때문이다. 걷기(walk)가 접어 넣지 못한 것은 버려지지 않고 헤더에 이름이 명시된다. 빈 로그는 손상된 로그와 별도로 집계된다. 0바이트 로그는 exec가 실패한 실행이나 아무도 호출하지 않은 HTTP 프록시의 일반적인 잔재이기 때문이다. 출력은 최신순이 아니라 이름순으로 정렬되어 한 디렉터리에 대한 두 번의 실행이 동일한 바이트를 생성하며, 이것이 나중에 diff할 기준선으로 사용할 수 있게 만드는 이유다. 두 가지 공백은 실수 때문이 아니라 설계상 존재한다. `--trace-file`이 있는 실행은 세션 디렉터리 밖에 기록했으므로 나타나지 않으며, `prune`은 로그를 삭제하므로 첫 발견 시점은 디스크에 남아 있는 것만큼만 오래될 수 있다. mcpsnoop은 이 머신에서 그것을 통해 실행된 것을 보고한다. 네트워크를 스캔하지 않고, 가리키지 않은 클라이언트 구성을 읽지 않으며, 어떤 것도 판단하지 않는다. ### 고장난 서버와 거절하는 도구 구분하기 `result.isError`로 응답하는 도구는 정상 작동 중이다. 살펴보고 아무것도 찾지 못했거나 입력을 거부한 것이다. JSON-RPC 오류로 응답하는 서버는 고장난 것이다. 둘 다 도구 요약에서 하나의 숫자였는데, 이는 도메인 실패를 보고하는 잘 작동하는 도구가 고장난 서버와 똑같이 보이고 그 위로 정렬된다는 뜻이었다. `ERR` 열이 둘을 구분한다. 빨간색은 서버 측, 즉 JSON-RPC 오류 또는 이유를 밝히지 않고 실패로 끝난 작업이다. 경고 색상은 도구 자체의 `isError`다. 둘 다 있는 도구는 개수가 결합되어 표시되며 빨간색이 먼저 오고, 설명할 경고 숫자가 있을 때마다 표 아래 줄이 두 합계를 명명한다. 내보내기는 `errors` 총계 옆에 `protocol_errors`와 `tool_errors`로 동일한 구분을 담으며, 둘은 항상 그 총계에 합산된다. `check --fail-on error`는 변경되지 않았으며 어느 쪽에서든 여전히 발동한다. 둘 중 하나를 무시하는 게이트는 서버가 다른 쪽을 반환하여 끌 수 있는 게이트가 되기 때문이다.```bash mcpsnoop export -T json | jq '.summary.tools[] | {name, errors, protocol_errors, tool_errors}'

내보내기는 도구별로 설명과 스키마 바이트로 구분된 동일한 수치를 담고 있어, 비대한 설명과 비대한 스키마가 분리된 상태를 유지하며 각각 캡처 간 추적할 수 있습니다. `mcpsnoop diff`는 두 세션 사이에 설명이나 스키마가 변경되었는지 알려줍니다. 그 변경의 크기가 존재하는 곳이 바로 내보내기입니다. **이것들은 바이트이지 토큰이 아닙니다.** 토큰 수는 모델에 따라 달라지므로, 이를 측정하려면 토크나이저를 포함하고 어떤 것을 선택할지 정해야 합니다. 바이트는 정확하며 자체 비율을 적용할 수 있습니다. 완료되지 않은 `tools/list`는 본 것을 하한선으로 보고하고 그렇게 명시하며, 부분 합계를 총계로 속이지 않습니다. ### 서버 상태를 훼손하는 클라이언트 감지 다중 왕복 패턴에서 서버는 클라이언트에게 불투명한 `requestState`를 건네주고, 클라이언트는 재시도 시 이를 그대로 다시 에코해야 합니다. 서버는 이를 공격자 통제 입력으로 취급하라고 지시받는데, 이를 변조하는 클라이언트는 서버 동작을 변경하거나 인가 검사를 우회하려 시도할 수 있기 때문입니다. 파이프에 위치한 mcpsnoop는 값이 나가고 돌아오는 것을 보므로, 계약이 깨졌을 때를 말할 수 있습니다. 깨질 수 있는 세 가지 방식이 있으며, 각각 재시도 시 프로토콜 경고로 보고됩니다. | 보고됨 | 의미 | |---|---| | `MRTR retry changed requestState` | 클라이언트가 서버가 발급한 것과 다른 것을 다시 보냄 | | `MRTR retry is missing requestState` | 서버가 발급했지만 재시도가 이를 생략함 | | `MRTR retry invented requestState` | 재시도가 서버가 발급한 적 없는 것을 담고 있음 | 이것들은 우리의 관찰이 아니라 클라이언트의 프로토콜 위반이므로, 일반 경고 신호를 타고 **기본 `check` 실행은 하나라도 있으면 실패합니다.** 이는 의도적입니다. 서버 상태를 훼손하는 클라이언트는 빌드를 중단할 가치가 있습니다. 값 자체는 표시되거나 기록되지 않으며, 어떤 것도 이를 디코딩하거나 파싱하지 않습니다. 이는 주체와 토큰을 담은 암호화된 블롭일 수 있으며, 불투명한 바이트를 비교하는 것이 전체 검사입니다. 한 가지 경우는 도달할 수 없습니다. 서버가 `requestState`로 응답하고 `inputRequests`가 없을 때, 변조된 재시도는 어떤 것과도 일치하지 않고 어떤 키에도 응답하지 않으므로 원래 요청에 연결할 것이 남지 않아 위반이 아닌 무관한 호출로 읽힙니다. 버려진 교환은 다음 교환을 방해하지 않으며, 영원히 보관되지도 않습니다. 64개의 열린 교환은 어떤 클라이언트가 동시에 보유하는 것보다 훨씬 많으므로, 그보다 많이 보유한 세션은 아무도 완료하지 않을 것들을 보유한 것이며, 가장 오래된 것은 서버에 그 상태에 짧은 만료를 부여하고 이후에는 거부하라고 스펙이 지시하기 때문에 폐기됩니다. 폐기는 조용히 이루어지지 않고 집계됩니다. 스트림 푸터는 `N unlinked`를 표시하고 내보내기는 `session.retired_exchanges`를 담는데, 폐기된 작업에 도착하는 재시도는 자체 호출로 읽히므로, 개수를 비교하는 독자는 그 사실을 알려받을 자격이 있기 때문입니다. 하나를 폐기하면 라이브 저장소도 이를 해제할 수 있습니다. 대기 중인 작업은 의도적으로 보류 상태를 유지하므로 그 기간이 전체 교환에 걸치며, 저장소는 응답이 여전히 올 수 있으므로 대기 중인 호출을 잊기를 거부합니다. 상한선이 작업을 폐기한 후에는 어떤 것도 응답할 수 없으므로, 이를 보유하면 어떤 독자도 도달할 수 없는 호출을 살아 있게 유지하는 것입니다. 세션이 보고하는 것은 변하지 않습니다. 여전히 대기 중으로 집계되고 `N unlinked`에도 집계되는데, 레코드가 차지하는 메모리 양과 레코드가 말하는 것은 서로 다른 질문이기 때문입니다. 버려진 교환은 다음 교환을 방해하지 않습니다. MRTR은 서버에게 클라이언트가 재시도할 것이라고 가정해서는 안 된다고 지시하므로, 사용자가 유도(elicitation)를 거절하면 이후 어떤 프레임도 해결하지 못할 작업이 남습니다. mcpsnoop는 먼저 `requestState` 존재가 재시도의 것과 일치하는 작업들 사이에서 찾는데, 스펙이 이를 양방향 규칙으로 만들므로, 준수하는 재시도는 같은 도구에 버려진 교환이 옆에 앉아 있어도 자신이 이어가는 하나의 작업을 여전히 찾습니다. 위의 세 가지 위반을 보고하는 검사는 아무것도 일치하지 않을 때만 실행되므로, 진정으로 비준수하는 재시도도 여전히 지목됩니다. ## 다른 머신에서 감시하기 캡처는 트래픽이 발생하는 머신에 국한하고 네트워크 홉에는 SSH를 사용하세요. 그러면 mcpsnoop는 자체 원격 전송이 필요하지 않습니다. ### 실시간 보기 워크스테이션에서 TUI를 실행하고 원격 머신의 mcpsnoop 소켓을 다시 전달하세요. 실시간 터널은 SSH Unix 소켓 전달을 사용하므로 양쪽 끝이 Linux 또는 macOS를 실행해야 합니다. Windows에서는 아래의 사후 로그 복사를 사용하세요.```bash # on your workstation, start the TUI mcpsnoop # create the remote socket directory once ssh remote-user@remote-host 'mkdir -p ~/.local/state/mcpsnoop' # print the tunnel command, then run the printed ssh -R line mcpsnoop remote remote-user@remote-host # on the remote host, wrap your server as usual mcpsnoop -- node build/index.js

## 보안 mcpsnoop은 래핑하는 서버 명령을 실행하므로, 신뢰하는 서버만 래핑하고 신뢰할 수 없는 서버는 컨테이너에서 실행하세요. 클라이언트 구성에 넣지 않은 것은 절대 실행하지 않습니다. 원격 워크플로의 경우 SSH 터널링 또는 SSH 파일 전송을 사용하여 전송 인증, 암호화, 호스트 검증, 키 순환 및 감사 정책이 기존 SSH 설정에 유지되도록 하세요. ### 캡처 내용 편집(Redacting) 캡처된 프레임에는 프롬프트, 도구 인수, 자격 증명 및 도구 결과가 포함될 수 있습니다. 페이로드에 비밀 정보가 포함될 수 있다면 편집(redaction)을 선택하여 관찰된 트레이스 복사본을 삭제하는 동시에 프록시된 바이트는 변경 없이 그대로 통과시키세요. 키 기반 편집은 일치하는 JSON 객체 키 아래의 전체 값을 대체하며, 동일한 키 집합은 래핑된 서버의 명령줄 인수에도 최선의 노력으로 적용되므로 `--api-key=sk-x` 및 `--token sk-x`는 `--redact-secrets` 아래에서 삭제됩니다. 인식 가능한 플래그 이름 없이 비밀 정보를 담은 인수는 감지할 수 없습니다. HTTP 엔드포인트는 그러한 범위에 포함되지 않습니다. 이는 사용자가 보내기로 선택한 페이로드가 아니기 때문입니다. `--target`은 프록시를 실행하기 위해 반드시 전달해야 하는 플래그이므로, 해당 URL은 편집 설정과 관계없이 세션 로그에 도달합니다. mcpsnoop은 이를 사용자 정보, 모든 쿼리 값 및 프래그먼트가 이미 제거된 상태로 항상 기록하며, 패턴이 아닌 구조적으로 그렇게 처리합니다. 쿼리 키는 유지되는데, 이는 한 호스트의 두 엔드포인트를 구분하는 요소이기 때문이며, 프래그먼트는 애초에 서버에 도달하지 않았으므로 삭제됩니다. 기록되는 내용은 서버를 식별할 뿐 연결을 시도할 주소가 아닙니다. 경로 기반 편집은 JSONPath 표현식으로 선택된 값만 대체하며, 공통 키 이름이 한 위치에서는 민감하지만 다른 위치에서는 안전할 때 유용합니다. `--redact-path`를 반복하여 둘 이상의 위치를 삭제하세요. 값 기반 편집은 관찰된 문자열 값, stderr 텍스트 및 비-JSON 텍스트 프레임에 정규식을 적용합니다. 세 가지 모두 최선의 노력 방식입니다. 정규식은 비밀 정보를 놓치거나, 무해한 텍스트를 과도하게 일치시키거나, 변환되거나 인코딩된 값을 감지하지 못할 수 있습니다. 편집은 결코 비난으로 변하지 않습니다. 관찰된 한 항목을 다른 항목과 비교하는 모든 검사(라우팅 헤더와 본문, `Mcp-Param` 값과 그것이 반영하는 인수, 도구 스키마와 개정판이 요구하는 사항)는 mcpsnoop이 바이트를 다시 쓴 쪽이었을 때 이를 인지하고, 사용자 자신의 개인정보 설정에 대해 서버를 보고하지 않고 침묵을 유지합니다. 도구 정의 드리프트는 의도적으로 예외인데, 편집을 켜면 기록되는 내용이 변경되고 따라서 기준선이 보유하는 내용도 변경되기 때문입니다. [도구 정의 드리프트 감지](#detect-tool-definition-drift)를 참조하세요.```bash # built-in preset of common secret keys mcpsnoop --redact-secrets -- node build/index.js # or name your own keys mcpsnoop --redact-key token,api_key,password -- node build/index.js # scrub one location without redacting every field named password mcpsnoop --redact-path '$.params.arguments.password' -- node build/index.js # wildcards scrub every matching array element mcpsnoop --redact-path '$.params.arguments.accounts[*].password' -- node build/index.js # scrub obvious token-shaped values outside known keys mcpsnoop --redact-value 'sk-[A-Za-z0-9]+' -- node build/index.js # combine the layers in http mode mcpsnoop http --target http://localhost:3000/mcp --redact-secrets --redact-value 'Bearer\s+\S+'

신호	실패 조건
`error`	JSON-RPC 오류로 응답된 호출, `isError`로 표시된 결과, 또는 실패로 종료된 작업
`invalid`	프로토콜 채널에서 유효한 JSON-RPC가 아닌 프레임, 일반적으로 서버가 stdout에 로그를 기록하는 경우
`warn`	MCP 또는 JSON-RPC 사양이 설정한 기대치를 위반하는 프레임
`mismatch`	본문과 일치하지 않는 라우팅 헤더, 배치에 편승하거나, 개정판이 요구하는 곳에서 누락된 경우
`pending`	캡처가 종료될 때 아직 열려 있는 요청으로, 호출자가 대기 상태로 남겨진 경우
`late-result`	요청이 취소된 후 도착한 응답
`drift`	기준선이 승인된 후 광고된 도구 정의가 변경된 경우
`deprecated`	사양이 더 이상 사용하지 않는 기능
`incomplete`	업스트림에서 드롭된 프레임으로, 다른 모든 수치가 총계가 아닌 최소값이 됨
`schema`	클라이언트 간 전달이 잘 되지 않는 구문 또는 방언을 사용하는 광고된 스키마

플래그	실패 조건
`--max-duration <dur>`	완료된 도구 호출 중 하나 이상이 예산을 초과한 경우, 해당 횟수와 최악의 호출을 보고
`--expect-tool <name>`	지정된 도구가 한 번도 호출되지 않은 경우 (반복 가능)
`--forbid-tool <name>`	지정된 도구가 호출된 경우 (반복 가능)

규칙	보고 방식
클라이언트는 `application/json`과 `text/event-stream`을 모두 나열하는 `Accept`를 전송해야 함(MUST)	요청에 대한 `warn`
JSON-RPC 요청에 응답하는 서버는 `Content-Type: application/json` 또는 `text/event-stream`을 반환해야 함(MUST)	응답에 대한 `warn`

mcpsnoop

인기

설정 파일

Go```bash

셸 완성 기능

작동 방식

Exporting sessions

Redaction

세션 비교

반드시 발생해야 하는 것과 발생하지 말아야 하는 것 검증

a contract for the run: search must run, delete must not, nothing over 2s

GitHub Action

본문과 일치하지 않는 라우팅 헤더 포착

사양이 필수로 규정하는 전송 헤더 확인

도구 정의 드리프트 감지

더 이상 사용되지 않는 프로토콜 기능 플래그 지정

HTTP로 캡처된 호출 재생

安装

使用方法

许可证

4번 중 1번 실패하는 도구 찾기

여기서 실제로 실행된 서버 확인하기

서버가 컨텍스트에서 얼마나 비용이 드는지 확인하세요

a non-Linux or custom home, macOS is /Users/ and root is /root

an explicit MCPSNOOP_HOME on the remote

an explicit XDG_STATE_HOME on the remote

copy the remote logs into your local sessions directory

open the TUI, it backfills the copied sessions

기여

라이선스