Skip to main content
Glama

@jshookmcp/jshook

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

Inglés | 中文

Un servidor MCP (Model Context Protocol) con un catálogo de herramientas integradas impulsado por un registro en tiempo de ejecución para el análisis de JavaScript y el análisis de seguridad asistido por IA. Combina automatización de navegadores, depuración con el protocolo Chrome DevTools, monitoreo de red, hooks de JavaScript inteligentes, análisis de código mediante LLM, inspección de procesos y memoria, herramientas WASM, reconstrucción de source-maps, transformaciones AST y flujos de trabajo compuestos en un solo servidor.

Documentación / Enlaces rápidos

Related MCP server: JS Reverse Strong MCP

🚀 Inicio rápido

Usa jshookmcp al instante con Claude Desktop o Cursor sin instalar nada globalmente.

Configuración de Claude Desktop (claude_desktop_config.json):

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

(Nota para usuarios de Windows: Si no se encuentra npx, especifica la ruta absoluta a npx.cmd)

🌟 Aspectos destacados

  • 🤖 Análisis impulsado por IA: Aprovecha los LLM para la desofuscación inteligente de JavaScript, la detección de algoritmos criptográficos y la comprensión de código a nivel de AST.

  • ⚡ Eficiencia de contexto centrada en la búsqueda: search_tools impulsado por BM25 + boosts dinámicos reducen el delta de inicio del esquema de herramientas de jshook de ~40.0K+ tokens (full) a ~3.0K (search) (recuento del lado del servidor de Claude; excluye el prompt base de Claude Code).

  • 🎯 Niveles de capacidad progresivos: Tres perfiles integrados (search/workflow/full), con search como nivel base predeterminado para el escalado de capacidades bajo demanda.

  • 🌐 Automatización Full-Stack: Orquesta sin problemas navegadores Chromium/Camoufox, depuración CDP e interceptación de red como acciones atómicas.

  • 🛡️ Anti-depuración avanzado: Evasión integrada para sentencias debugger, comprobaciones de tiempo y técnicas estrictas de huella digital de bots headless.

  • 🧩 Extensibilidad dinámica: Recarga en caliente de plugins y flujos de trabajo desde directorios locales sin recompilar el servidor principal.

  • 🔧 Extensibilidad sin cableado: Dominios descubiertos automáticamente mediante manifest.ts, instanciación diferida de manejadores y contratos B-Skeleton para plugins/flujos de trabajo.

  • 🛠️ Cadena de herramientas de ingeniería inversa: Desensamblado WASM integrado, análisis de entropía binaria, escaneo en memoria y puentes para Burp Suite/Ghidra/IDA Pro.

🛡️ Capacidades principales

JSHookMCP expone más de 360 herramientas atómicas en 36 dominios, dotando a los orquestadores de IA con capacidades inigualables:

  • 🕸️ Automatización de navegadores e ingeniería inversa: Inyección de Chromium/Camoufox sin configuración, orquestación de CDP (Chrome DevTools Protocol) y omisiones de evaluación de iframe.

  • 📡 Interceptación y suplantación de red: Construcción profunda de tramas HTTP/2, captura de tráfico MiTM, introspección de GraphQL y puente de Burp Suite.

  • 🧠 AST y análisis semántico: Desofuscación impulsada por LLM, desensamblado de WebAssembly (WASM), reconstrucción de Source Map y visualización de entropía binaria.

  • 🧰 Forense de procesos y memoria: Instrumentación nativa de Frida, escaneo de memoria, desreferenciación de punteros y mitigación estricta de Anti-Debug.

  • 🔌 Extensibilidad dinámica: Plugins B-Skeleton recargables en caliente y tuberías declarativas de WorkflowContract.

Ver el catálogo completo de 36 dominios de herramientas ↗

Arquitectura y rendimiento

[!TIP] Benchmark de eficiencia de contexto: Delta de inicio del esquema de herramientas integrado (recuento del lado del servidor de Claude): search ≈ 3.0K tokens frente a full ≈ 40.0K+ tokens.

  • Descubrimiento progresivo de herramientas: Meta-herramienta search_tools (ranking BM25) + activate_tools / activate_domain + actualizaciones de nivel basadas en perfiles (boost_profile)

  • Comportamiento del nivel de búsqueda: search_tools solo busca y clasifica resultados; no ejecuta automáticamente activate_tools ni boost_profile. Cadena preferida: search_tools -> activate_tools / activate_domain -> boost_profile solo cuando sea necesario

  • No potenciar para una sola herramienta: activate_tools puede registrar herramientas exactas entre niveles desde el nivel base actual; boost_profile es mejor cuando esperas reutilizar repetidamente una amplia familia de herramientas relacionadas

  • Inicialización diferida de dominios: Clases de manejadores instanciadas mediante Proxy en la primera invocación, no durante el inicio

  • Autodescubrimiento de dominios: El escaneo de manifiestos en tiempo de ejecución (domains/*/manifest.ts) reemplaza las importaciones codificadas; añade nuevos dominios creando un único archivo de manifiesto

  • Contratos B-Skeleton: Contratos de extensibilidad para plugins (PluginContract), flujos de trabajo (WorkflowContract) y observabilidad (InstrumentationContract)

  • MCP ToolAnnotations: Cada herramienta lleva anotaciones semánticas (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) que permiten a los orquestadores de IA razonar sobre la seguridad de la herramienta y los efectos secundarios antes de la invocación

Instantánea del registro

La superficie integrada a continuación se genera a partir del registro en tiempo de ejecución y se verifica en CI.

  • Versión del paquete: 0.3.0

  • Herramientas integradas: 387

  • Dominios: 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

  • Nota: esta instantánea se genera a partir del registro en tiempo de ejecución; no edites los recuentos manualmente.

Ver la referencia completa de herramientas ↗

Estadísticas del proyecto

Historial de estrellas

Actividad

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