_{حفلة تنكرية من عصر النهضة. اجلس في مقعد الوكيل.}

masq

اجلس في مقعد الوكيل.

واجهة CLI تتحدث MCP وتوافق OpenAI تمامًا كما يفعل النموذج، ثم تُبلغ بأسلوب linpeas. استنتاجات مع الإصلاحات. بلا حمولات استغلال. بلا فك تشفير CoT.

لماذا وُجدت هذه الأداة

الماسحات الساكنة لـ MCP (Invariant mcp-scan, mcp-security-scan) تفحص المخططات والإعدادات. أدوات الفحص الصحي تبعث ping إلى initialize. الثغرة هي المقعد:

1. يُعاد صدى كتل التفكير المشفّرة إلى العميل وتُخزَّن في سجلات الجلسات. وهي قابلة للنقل عبر الجلسات والمستخدمين والنماذج الشقيقة الأضعف (arXiv:2608.09867). كشط 315 ألف كتلة عامة استعاد 182 مُعرّف اعتماد. masq تكشف تلك الكتل. إنها لا تفكّ تشفيرها.
2. نسبة كبيرة من خوادم MCP العامة بلا مصادقة. إذا استطعت initialize، فأنت الوكيل بذاته.
3. منافذ النماذج المحلية (:11434, :8000) كثيرًا ما تُربط على 0.0.0.0 دون رمز bearer.

عجلات نستخدمها لا نعيد كتابتها: كاشفات الكتالوج الحالية + 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

المجموعة الشاملة (الملف التنفيذي ضد الـ fixtures، ومحاكاة محلية، واستطلاع لهذا المضيف):

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:// غير مدمجة. استخدم Stunnel للوصول إلى ws:// أو استخدم HTTP. HTTP لا يتبع أي عمليات إعادة توجيه.

فإن initialize عبر stdio لا يعلن عن 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.

بالإضافة إلى .mcp.json في دليل العمل الحالي وMASQ_EXTRA_CONFIG (قائمة مسارات نظام التشغيل).

القائمة المسموحة للمختبر (--lab)

--lab قائمة مسموحة وليست فحصًا لنطاق /24. وهي مضبوطة من المشغّل. لا شيء مُضمّن في البناء خارج loopback.

• متغير البيئة MASQ_LAB_HOSTS: مضيف:منفذ أو مضيفات مفصولة بفواصل أو مسافات أو أسطر جديدة.
• ملف .masq/lab-hosts: مضيف واحد لكل سطر، وتعليقات #.

مثال:

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

يُقرأ MASQ_LAB_HOSTS لفحوصات API وتجميع أسطول TUI. يوفّر MASQ_SIT_URLS (أو --mcp-url) عناوين MCP URLs للجلوس عليها مع --lab.

يتطلب sit --url خارج loopback --lab ومضيفًا في القائمة المسموحة. مستوى initialize غير المصادق عبر loopback هو High. وخارج الجهاز هو Critical.

لا توجه proxy إلى مضيف لا ترغب بالجلوس عليه.

الحدود القصوى

أولوية Sniff: chat_history.jsonl أولًا، ثم Hermes request_dump_*، ثم باقي ملفات jsonl. يكتمل التجوال. لا يحتفظ بأول 300 نتيجة من WalkDir. وجّه masq sniff <one-session-dir> للتعمق أكثر.

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 بالإضافة إلى + severity title و- severity title.

classify --llm وإضافة فرز TUI هما الوحيدتان اللتان ترسلان POST لعمليات completions (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

مكتبة crate: masq (scan_from_tools_list, scan_stdio, run_seat, PostureReport).

النطاق الصريح

لا تُلقِ محتويات ~/.secrets. Recon تعدّ الملفات. المسار + "loaded".

الاختبارات دون اتصال

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

توقع خروج 0.

الـ Fixtures: تسميم الوصف T1، والقفز السطري T3، وأسماء الوسائط T6، وANSI T8، والأسماء المكررة T13، وسحب بساط التثبيت، وقائمة متعددة، ومحاكاة NDJSON حية في tests/mock_mcp_server.py.

تبقى الأسرار خارج git (reports/, data/, .env, *.key, secrets/, .masq/).

الترخيص

MIT. حقوق النشر 2026 SamsonCyber.