_{르네상스 가장무도회. 에이전트의 자리에 앉으세요.}

masq

에이전트의 자리에 앉으세요.

모델과 같은 방식으로 MCP와 OpenAI 호환 프로토콜을 구사한 뒤, linpeas처럼 보고하는 CLI입니다. 발견 사항과 수정 조치를 함께 제공합니다. 익스플로잇 페이로드 없음. CoT 복호화 없음.

왜 필요한가

정적 MCP 스캐너(Invariant mcp-scan, mcp-security-scan)는 스키마와 구성을 린트합니다. 상태 점검 도구는 initialize를 핑합니다. 빈틈은 바로 seat입니다:

1. 암호화된 추론 블롭은 클라이언트로 에코되고 세션 로그에 저장됩니다. 이 블롭은 세션, 사용자, 더 약한 형제 모델 간에 이식 가능합니다(arXiv:2608.09867). 공개 블롭 315,000개를 스크래핑하여 자격 증명 182개를 복구했습니다. masq는 그러한 블롭을 탐지합니다. 복호화하지는 않습니다.
2. 공개 MCP 서버 상당수가 인증이 없습니다. initialize를 할 수 있다면, 당신이 바로 에이전트입니다.
3. 로컬 모델 포트(:11434, :8000)는 종종 bearer 없이 0.0.0.0에 바인딩됩니다.

우리가 다시 만들지 않고 그대로 활용하는 것들: 기존 카탈로그 탐지기 + pin/check, netstat, GET 전용 ureq, 발견 사항 분류 체계로서의 OWASP MCP Top 10. 우리는 mcp-scan이나 mcp-security-scan을 복제하지 않았습니다.

설치

git clone https://gitlab.com/WattoCyber/masq.git
cd masq
cargo install --path .
# binary: masq
cargo test
# expect: exit 0

월드 스위트(픽스처, 로컬 목, 이 호스트 정찰에 대한 바이너리 기반):

python scripts/world_suite.py
# field = ~/.grok/sessions  lab = allowlisted hosts  bench = frozen-corpus wall
python scripts/world_suite.py --lanes all

데스크톱에서 Kali 스타일 원격 박스로 배포:

MASQ_REMOTE_HOST=user@host bash scripts/deploy_kali.sh
# on the box:
~/.local/bin/masq --plain
MASQ_LAB_HOSTS=... ~/.local/bin/masq --lab --plain

기본 사용 경로

masq                         # live stream + posture report (includes skills)
masq --lab                   # same, plus allowlisted homelab hosts
masq tui                     # boxed TUI, stays until Ctrl+C
masq --plain                 # report only, no live stream
masq --json                  # machine report
masq recon                   # same dump, recon only
masq sniff ~/.grok/sessions  # CoT / secrets in session logs
masq sniff --timeline PATH   # file-order blob/secret/reason lines (no decrypt)
masq api                     # GET /v1/models on local (and --lab) ports
masq sit --url http://127.0.0.1:4443/mcp
masq chameleon --url http://127.0.0.1:4443/mcp -o /tmp/chameleon
masq chameleon --url ws://127.0.0.1:9000/mcp -o /tmp/chameleon
masq chameleon --url unix:///tmp/mcp.sock -o /tmp/chameleon
masq chameleon --token-file ~/.secrets/mcp.txt --url http://127.0.0.1:9/mcp -o /tmp/chameleon
masq chameleon -- python -m their_mcp -o /tmp/chameleon
# then: npx -y @copilotkit/aimock --config /tmp/chameleon/aimock.json
masq discover                # find VS Code / Cursor / Claude / Grok / Hermes MCP configs
masq proxy --upstream http://127.0.0.1:4443/mcp --block
masq sast ./server           # local sinks (semgrep if present)
masq classify --url http://127.0.0.1:4443/mcp --lab
masq overnight --lab --hours 6
masq map --from reports/overnight-YYYYMMDD/latest.json

# catalog
masq fixtures/t3_line_jump.json
masq fixtures/clean_calculator.json --trusted
masq pin fixtures/clean_calculator.json -k calc
masq check fixtures/clean_calculator.json -k calc
masq detectors

종료 코드: 0 깨끗함 · 2 발견 사항 ≥ --fail-on(기본값 high) · 1 오류.

TUI는 옵트인입니다(masq tui 또는 --tui). tty에서는 기본적으로 linpeas 라이브 스트림 후 보고서가 표시됩니다. Cron에서는 --plain / --no-color를 사용합니다.

명령어

별칭: doctor / audit → scan. chameleon → mimic. posture → seat.

모듈과 OWASP MCP Top 10

전송 방식과 인증

sit / chameleon이 구사하는 프로토콜:

• Streamable HTTP (http://)
• HTTP+SSE(GET 엔드포인트 이벤트 후 POST)
• ws://
• unix: 및 npipe:
• stdio(--framing auto는 NDJSON을 시도한 후 Content-Length)

인증(보고서에 덤프되지 않음):

• --token-file PATH(첫 번째 줄이 Authorization: Bearer …가 됨)
• --token-env VAR
• --header "Name: value"(반복 가능)

wss://는 내장되어 있지 않습니다. ws://로 Stunnel을 쓰거나 HTTP를 사용하세요. HTTP는 리다이렉트를 전혀 따르지 않습니다.

Stdio initialize는 sampling을 광고하지 않습니다. 서버의 sampling / elicitation을 플래그로 표시하세요. 문서 URL(model-catalog.json, /docs/)은 의도적으로 무시됩니다.

masq가 발견하는 호스트

$HOME / %USERPROFILE% 아래의 구성 + 스킬 루트:

VS Code, Cursor, Windsurf, Claude Desktop, Claude Code, Grok, Hermes, Codex, Continue, Gemini CLI, Amp, Kiro, OpenCode, Amazon Q, Antigravity, OpenClaw.

추가로 cwd의 .mcp.json 및 MASQ_EXTRA_CONFIG(OS 경로 목록).

Lab 허용 목록(--lab)

--lab은 /24 스캔이 아니라 허용 목록입니다. 운영자가 구성합니다. 루프백 외에는 아무것도 컴파일되어 있지 않습니다.

• MASQ_LAB_HOSTS 환경 변수: 쉼표, 공백 또는 줄바꿈으로 구분된 host:port 또는 호스트 목록.
• .masq/lab-hosts 파일: 줄마다 호스트 하나, #는 주석.

예:

export MASQ_LAB_HOSTS="192.0.2.10,192.0.2.11"
masq --lab

MASQ_LAB_HOSTS는 API 프로브와 TUI fleet 롤업에 사용됩니다. MASQ_SIT_URLS(또는 --mcp-url)는 --lab과 함께 sit할 MCP URL을 제공합니다.

루프백이 아닌 sit --url에는 --lab과 허용 목록에 등록된 호스트가 필요합니다. 루프백에서 인증 없는 initialize는 High입니다. 박스 외부에서는 Critical입니다.

sit하지 않을 호스트를 proxy에 지정하지 마세요.

하드 한도

sniff 우선순위: chat_history.jsonl 먼저, 그다음 Hermes request_dump_*, 그다음 기타 jsonl. 전체 탐색은 끝까지 수행됩니다. 처음 300개의 WalkDir 적중 항목만 취하지 않습니다. 더 깊이 조사하려면 masq sniff <세션-디렉터리-하나>를 지정하세요.

Overnight

masq overnight --lab --hours 6 --interval-mins 20
# writes <cwd>/reports/overnight-YYYYMMDD/{latest.json,latest.md,latest.txt,delta.txt}

구성을 변경하지 않습니다. 라이브 서버에 tools/call을 하지 않습니다. delta.txt는 baseline / no_change / CHANGE에 + 심각도 제목과 - 심각도 제목을 더한 형태입니다.

classify --llm과 TUI 트리아지 애드온만이 유일한 completions POST입니다(Grok /v1/chat/completions, 운영자 확인). 키가 없으면 로컬 수정 조치만 제공됩니다. 키는 XAI_API_KEY 또는 ~/.secrets/xai.txt에서 가져옵니다. 절대 덤프되지 않습니다.

아키텍처

CLI (clap)  masq
  → seat | recon | sniff | api | sit | chameleon
  → discover | proxy | sast | classify | overnight | map
  → scan | multi | pin | check | detectors | tui
  → client (HTTP / SSE / ws / unix / npipe / stdio)
  → normalize (full-schema walk, caps)
  → detectors + sniff + recon + sit findings
  → report (text / JSON / Markdown) + optional TUI

라이브러리 크레이트: masq(scan_from_tools_list, scan_stdio, run_seat, PostureReport).

정직한 범위

~/.secrets를 덤프하지 마세요. Recon은 파일 수를 셉니다. 경로 + "loaded"만 표시합니다.

오프라인 테스트

cargo test
cargo clippy --all-targets -- -D warnings

종료 코드 0을 기대합니다.

픽스처: T1 설명 포이즈닝, T3 라인 점프, T6 파라미터 이름, T8 ANSI, T13 중복 이름, 핀 러그풀, 다중 목록, tests/mock_mcp_server.py의 라이브 NDJSON 목.

시크릿은 git에 포함되지 않습니다(reports/, data/, .env, *.key, secrets/, .masq/).

라이선스

MIT. Copyright 2026 SamsonCyber.