Skip to main content
Glama

@jshookmcp/jshook

License: AGPLv3 Node.js 20.19+ or 22.12+ TypeScript MCP pnpm

English | 中文

MCP-сервер (Model Context Protocol) с каталогом встроенных инструментов на основе реестра времени выполнения для анализа JavaScript и безопасности с помощью ИИ. Он объединяет автоматизацию браузера, отладку через Chrome DevTools Protocol, мониторинг сети, интеллектуальные JavaScript-хуки, анализ кода с помощью LLM, инспекцию процессов и памяти, инструменты WASM, восстановление source-map, преобразования AST и составные рабочие процессы в одном сервере.

Документация / Полезные ссылки

Related MCP server: JS Reverse Strong MCP

🚀 Быстрый старт

Используйте jshookmcp мгновенно с Claude Desktop или Cursor без глобальной установки.

Конфигурация Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "jshook": {
      "command": "npx",
      "args": ["-y", "@jshookmcp/jshook@latest"],
      "env": {
        "JSHOOK_BASE_PROFILE": "search"
      }
    }
  }
}

(Примечание для пользователей Windows: если npx не найден, укажите абсолютный путь к npx.cmd)

🌟 Ключевые особенности

  • 🤖 Анализ на базе ИИ: Используйте LLM для интеллектуальной деобфускации JavaScript, обнаружения криптографических алгоритмов и понимания кода на уровне AST.

  • ⚡ Эффективность контекста с приоритетом поиска: search_tools на базе BM25 + динамические ускорения сокращают дельту инициализации схемы инструментов jshook с ~40.0K+ токенов (full) до ~3.0K (search) (подсчет на стороне сервера Claude; исключая базовый промпт Claude Code).

  • 🎯 Прогрессивные уровни возможностей: Три встроенных профиля (search/workflow/full), где search является базовым уровнем по умолчанию для масштабирования возможностей по требованию.

  • 🌐 Полностековая автоматизация: Бесшовная оркестрация браузеров Chromium/Camoufox, отладка CDP и перехват сети как атомарные действия.

  • 🛡️ Продвинутая защита от отладки: Встроенные механизмы обхода операторов debugger, проверок времени и строгих методов снятия отпечатков headless-ботов.

  • 🧩 Динамическая расширяемость: «Горячая» перезагрузка плагинов и рабочих процессов из локальных директорий без перекомпиляции основного сервера.

  • 🔧 Расширяемость без настройки: Автоматическое обнаружение доменов через manifest.ts, ленивая инициализация обработчиков и контракты B-Skeleton для плагинов/рабочих процессов.

  • 🛠️ Инструментарий обратной разработки: Интегрированная дизассемблия WASM, анализ энтропии бинарных файлов, сканирование памяти и мосты для Burp Suite/Ghidra/IDA Pro.

🛡️ Основные возможности

JSHookMCP предоставляет более 360 атомарных инструментов в 36 доменах, наделяя ИИ-оркестраторы непревзойденными возможностями:

  • 🕸️ Автоматизация браузера и обратная разработка: Инъекция Chromium/Camoufox без настройки, оркестрация CDP (Chrome DevTools Protocol) и обход оценки iframe.

  • 📡 Перехват и подмена сети: Построение фреймов HTTP/2, захват трафика MiTM, интроспекция GraphQL и мост Burp Suite.

  • 🧠 AST и семантический анализ: Деобфускация с помощью LLM, дизассемблия WebAssembly (WASM), восстановление Source Map и визуализация энтропии бинарных файлов.

  • 🧰 Криминалистика процессов и памяти: Инструментарий Frida, сканирование памяти, разыменование указателей и строгая защита от отладки.

  • 🔌 Динамическая расширяемость: Плагины B-Skeleton с «горячей» перезагрузкой и декларативные конвейеры WorkflowContract.

Посмотреть полный каталог из 36 доменов ↗

Архитектура и производительность

[!TIP] Бенчмарк эффективности контекста: Дельта инициализации схемы встроенных инструментов (подсчет на стороне сервера Claude): search ≈ 3.0K токенов против full ≈ 40.0K+ токенов.

  • Прогрессивное обнаружение инструментов: Мета-инструмент search_tools (ранжирование BM25) + activate_tools / activate_domain + повышение уровня на основе профиля (boost_profile)

  • Поведение уровня поиска: search_tools только ищет и ранжирует результаты; он не запускает автоматически activate_tools и не запускает boost_profile. Рекомендуемая цепочка: search_tools -> activate_tools / activate_domain -> boost_profile только при необходимости

  • Не повышайте уровень для одного инструмента: activate_tools может регистрировать конкретные инструменты из разных уровней, начиная с текущего базового; boost_profile лучше использовать, когда вы планируете многократно использовать широкое семейство связанных инструментов

  • Ленивая инициализация доменов: Классы обработчиков создаются через Proxy при первом вызове, а не во время запуска

  • Самообнаружение доменов: Сканирование манифеста во время выполнения (domains/*/manifest.ts) заменяет жестко закодированные импорты; добавляйте новые домены, создавая один файл манифеста

  • Контракты B-Skeleton: Контракты расширяемости для плагинов (PluginContract), рабочих процессов (WorkflowContract) и наблюдаемости (InstrumentationContract)

  • Аннотации инструментов MCP: Каждый инструмент содержит семантические аннотации (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), позволяющие ИИ-оркестраторам оценивать безопасность инструмента и побочные эффекты перед вызовом

Снимок реестра

Приведенная ниже поверхность инструментов генерируется из реестра времени выполнения и проверяется в CI.

  • Версия пакета: 0.3.0

  • Встроенные инструменты: 387

  • Домены: adb-bridge, antidebug, binary-instrument, boringssl-inspector, browser, canvas, coordination, core, cross-domain, debugger, encoding, evidence, extension-registry, graphql, hooks, instrumentation, macro, maintenance, memory, mojo-ipc, network, platform, process, protocol-analysis, proxy, sandbox, shared-state-board, skia-capture, sourcemap, streaming, syscall-hook, trace, transform, v8-inspector, wasm, workflow

  • Примечание: этот снимок генерируется из реестра времени выполнения; не редактируйте счетчики вручную.

Посмотреть полный справочник инструментов ↗

Статистика проекта

История звезд

Активность

Available Tools

8 tools
activate_domainA

Register every tool in a single domain at once. Use this when a task needs a whole capability area; prefer search_tools or activate_tools when you only need a few specific tools, because activating a domain costs far more context. Domains: . Activated tools appear in the tool list immediately; if your client does not refresh its tool list, invoke them with call_tool. Activation draws on the session context budget: when the budget is full, least-recently-used tools are evicted to make room, and the response reports what was activated and what was evicted. Pass precheck: true to preview wouldActivate / wouldEvict without changing anything. Activated tools auto-deactivate after ttlMinutes (default 30; pass 0 for no expiry). Use reload_extensions first to include external plugin/workflow domains.

Inputs: domain (required), precheck, ttlMinutes.

activate_toolsA

Dynamically register specific tools by name, regardless of current base tier. Use after search_tools to enable exactly the tools you need. In search-tier sessions this is usually enough; use activate_domain when you need every tool in a domain. Activated tools appear in the tool list immediately. If tools do not appear after activation, use call_tool to invoke them directly.

Inputs: names (required), precheck.

call_toolA

Execute an already-active tool by name. Use this when activate_tools/activate_domain registered a tool but your client did not refresh its tool list. Does not auto-activate inactive tools.

Inputs: name (required), args, arguments, parameters.

coverage_reportA

Report which tools have been called in the current runtime and which known tools remain uncalled. Loads all domains first so the uncalled list reflects the full tool catalog, not just currently active tools.

Inputs: no named parameters.

deactivate_toolsA

Remove previously activated tools to free context. Only affects dynamically activated tools (added via activate_tools, activate_domain, or extension activation), not base profile tools.

Inputs: names (required).

describe_toolA

Get detailed information about a specific tool, including its input schema. Use this to see the exact parameters a tool expects before calling it.

Inputs: name (required).

route_toolA

One-stop tool router: accepts a natural language task description, returns recommended tools and next actions. Automatically detects workflow patterns, recommends activation order, and provides example arguments. Use this instead of search_tools when you want guided tool discovery with actionable next steps.

Inputs: task (required), context.

search_toolsA

Search 736 tools across 36 capability domains. This includes built-in tools plus any loaded plugin/workflow tools (0 currently loaded). In search-tier sessions, call this before assuming a capability is unavailable. Use activate_tools for exact matches, activate_domain for an entire domain. Domains: browser (85) | memory (75) | native-emulator (57) | binary-instrument (46) | network (38) | process (29) | tls-inspector (29) | adb-bridge (26) | core (25) | debugger (21) | exploit-dev (21) | v8-inspector (21) | protocol-analysis (20) | platform (18) | maintenance (17) | streaming (17) | wasm (17) | dart-inspector (16) | syscall-hook (15) | instrumentation (13) | workflow (13) | coordination (12) | canvas (11) | proxy (11) | trace (10) | webgpu (10) | cross-domain (8) | mojo-ipc (8) | transform (8) | extension-registry (7) | graphql (7) | sourcemap (7) | native-bridge (6) | encoding (5) | tasks (4) | session (3). Query tip: before searching, distill your intent into key concepts (action verb + target + domain). The engine combines token matching, fuzzy names, profile context, and optional static embeddings.

Inputs: query (required), top_k, auto_activate.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 8 tools

    Disambiguation4/5

    Most tools have clearly distinct roles: discovery (search_tools, route_tool, describe_tool), activation lifecycle (activate_tools, activate_domain, deactivate_tools), execution (call_tool), and reporting (coverage_report). The only mild overlaps are search_tools vs route_tool (both discovery) and activate_tools vs activate_domain, but the descriptions explicitly differentiate them by intent and cost.

    Naming Consistency4/5

    Nearly all names follow a consistent verb_noun snake_case pattern (search_tools, activate_tools, call_tool, describe_tool). The main deviation is coverage_report, which is a noun phrase rather than an action, but it remains readable and predictable.

    Tool Count5/5

    Eight tools is well-scoped for a meta-server that manages 736 tools across 36 domains. Each tool covers a distinct phase of the discovery-activation-execution lifecycle and none feels redundant or filler.

    Completeness3/5

    The surface covers discovery, activation, deactivation, execution, and coverage reporting, but there is no dedicated tool to list currently active tools or enumerate domains, and activate_domain's domain list is empty. The descriptions also reference reload_extensions, which is not present in the tool set, creating a dead end for plugin/workflow domain loading.

    Maintenance

    ActivityActive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers