_{पुनर्जागरण मास्करेड। एजेंट की सीट पर बैठें।}

masq

एजेंट की सीट पर बैठें।

एक CLI जो मॉडल की तरह MCP और OpenAI-संगत बोलता है, फिर linpeas की तरह रिपोर्ट करता है। निष्कर्ष और सुधार। कोई exploit पेलोड नहीं। कोई CoT डिक्रिप्ट नहीं।

यह क्यों मौजूद है

स्टैटिक MCP स्कैनर (Invariant mcp-scan, mcp-security-scan) स्कीमा और कॉन्फ़िग को lint करते हैं। हेल्थ डॉक्टर initialize को ping करते हैं। कमी सीट (seat) है:

1. एन्क्रिप्टेड रीज़निंग ब्लॉब्स क्लाइंट को इको किए जाते हैं और सत्र लॉग में संग्रहीत होते हैं। वे सत्रों, उपयोगकर्ताओं और कमज़ोर सहोदर मॉडलों (arXiv:2608.09867) के बीच पोर्टेबल हैं। 315k सार्वजनिक ब्लॉब्स को स्क्रेप करने पर 182 क्रेडेंशियल प्राप्त हुए। masq उन ब्लॉब्स का पता लगाता है। वह उन्हें डिकोड नहीं करता।
2. सार्वजनिक MCP सर्वरों के एक बड़े हिस्से में कोई प्रमाणीकरण नहीं होता। यदि आप initialize कर सकते हैं, तो आप ही एजेंट हैं।
3. स्थानीय मॉडल पोर्ट (:11434, :8000) अक्सर बिना बियरर के 0.0.0.0 पर बाइंड होते हैं।

हम जिन पहियों पर सवार हैं, उन्हें दोबारा नहीं लिखते: मौजूदा कैटलॉग डिटेक्टर + pin/check, netstat, ureq GET-ओनली, 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

वर्ल्ड सूट (फिक्स्चर के विरुद्ध बाइनरी, स्थानीय मॉक्स, इस-होस्ट recon):

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 लाइव स्ट्रीम है, फिर रिपोर्ट। क्रॉन --plain / --no-color का उपयोग करता है।

कमांड्स

उपनाम: doctor / audit → scan। chameleon → mimic। posture → seat।

मॉड्यूल बनाम OWASP MCP Top 10

ट्रांसपोर्ट और प्रमाणीकरण

sit / chameleon ये बोलते हैं:

• Streamable HTTP (http://)
• HTTP+SSE (GET endpoint इवेंट, फिर 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 एक एलाउलिस्ट है, /24 स्कैन नहीं। यह ऑपरेटर-कॉन्फ़िगर्ड है। लूपबैक के अलावा कुछ भी कंपाइल-इन नहीं है।

• MASQ_LAB_HOSTS env वेरिएबल: कॉमा-, स्पेस- या न्यूलाइन-सेपरेटेड host:port या होस्ट।
• .masq/lab-hosts फ़ाइल: प्रति पंक्ति एक होस्ट, # टिप्पणियाँ।

उदाहरण:

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

API प्रोब्स और TUI फ्लीट रोलअप के लिए MASQ_LAB_HOSTS पढ़ा जाता है। MASQ_SIT_URLS (या --mcp-url) --lab के साथ sit करने के लिए MCP URL प्रदान करता है।

ऑफ-लूपबैक sit --url के लिए --lab और एक एलाउलिस्टेड होस्ट चाहिए। लूपबैक पर बिना-प्रमाणीकरण initialize हाई (High) है। ऑफ-बॉक्स क्रिटिकल (Critical) है।

proxy को ऐसे होस्ट पर न लगाएँ जिस पर आप sit नहीं करेंगे।

हार्ड सीमाएँ

Sniff प्राथमिकता: पहले chat_history.jsonl, फिर Hermes request_dump_*, फिर अन्य jsonl। वॉक पूरा होता है। यह पहले 300 WalkDir हिट्स को नहीं रखता। गहराई तक जाने के लिए masq sniff <one-session-dir> पर इंगित करें।

ओवरनाइट

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 के साथ-साथ + severity title और - severity title होते हैं।

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 डुप्लीकेट नाम, pin रग-पुल, मल्टी-लिस्ट, tests/mock_mcp_server.py के अंतर्गत लाइव NDJSON मॉक।

सीक्रेट्स git से बाहर रहते हैं (reports/, data/, .env, *.key, secrets/, .masq/)।

लाइसेंस

MIT। कॉपीराइट 2026 SamsonCyber।