@jshookmcp/jshook

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

• 📖 Leer la documentación

• 🚀 Primeros pasos

• ⚙️ Configuración

• 📚 Referencia de herramientas

🚀 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

• 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