Skip to main content
Glama

@jshookmcp/jshook

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

English | 中文

AI支援によるJavaScript解析およびセキュリティ解析のための、ランタイムレジストリ駆動型カタログを備えたMCP(Model Context Protocol)サーバーです。ブラウザ自動化、Chrome DevTools Protocolデバッグ、ネットワーク監視、インテリジェントなJavaScriptフック、LLMによるコード解析、プロセスおよびメモリ検査、WASMツール、ソースマップ再構築、AST変換、複合ワークフローを単一のサーバーに統合しています。

ドキュメント / クイックリンク

Related MCP server: JS Reverse Strong MCP

🚀 クイックスタート

グローバルにインストールすることなく、Claude DesktopやCursorでjshookmcpをすぐに使用できます。

Claude Desktop設定 (claude_desktop_config.json):

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

(Windowsユーザーへの注意: npxが見つからない場合は、npx.cmdへの絶対パスを指定してください)

🌟 主なハイライト

  • 🤖 AI駆動型解析: LLMを活用して、インテリジェントなJavaScriptの難読化解除、暗号アルゴリズムの検出、ASTレベルのコード理解を実現します。

  • ⚡ 検索ファーストのコンテキスト効率: BM25駆動の search_tools + 動的ブーストにより、jshookのツールスキーマ初期化デルタを約40.0K+トークン(full)から約3.0K(search)に削減します(Claudeサーバー側のカウント。Claude Codeのベースプロンプトを除く)。

  • 🎯 段階的な機能階層: 3つの組み込みプロファイル(search/workflow/full)があり、searchがオンデマンドで機能を拡張するためのデフォルトのベース階層となります。

  • 🌐 フルスタック自動化: Chromium/Camoufoxブラウザ、CDPデバッグ、ネットワークインターセプトをシームレスにアトミックなアクションとしてオーケストレーションします。

  • 🛡️ 高度なアンチデバッグ: debugger文、タイミングチェック、厳格なヘッドレスボットのフィンガープリント技術に対する組み込みの回避策を備えています。

  • 🧩 動的な拡張性: コアサーバーを再コンパイルすることなく、ローカルディレクトリからプラグインやワークフローをホットリロードします。

  • 🔧 ゼロ配線の拡張性: manifest.tsによるドメインの自動検出、ハンドラーの遅延インスタンス化、プラグイン/ワークフロー用のB-Skeletonコントラクト。

  • 🛠️ リバースエンジニアリングツールチェーン: 統合されたWASM逆アセンブル、バイナリのエントロピー解析、メモリ内スキャン、Burp Suite/Ghidra/IDA Proへのブリッジ。

🛡️ コア機能

JSHookMCPは36ドメインにわたる360以上の原子ツールを公開しており、AIオーケストレーターに比類のない機能を提供します:

  • 🕸️ ブラウザ自動化とリバースエンジニアリング: 設定不要のChromium/Camoufoxインジェクション、CDP(Chrome DevTools Protocol)オーケストレーション、iframe評価のバイパス。

  • 📡 ネットワークインターセプトとスプーフィング: 高度なHTTP/2フレーム構築、MiTMトラフィックキャプチャ、GraphQLイントロスペクション、Burp Suiteブリッジ。

  • 🧠 ASTとセマンティック解析: LLMによる難読化解除、WebAssembly (WASM) 逆アセンブル、ソースマップ再構築、バイナリのエントロピー可視化。

  • 🧰 プロセスとメモリのフォレンジック: ネイティブFridaインストゥルメンテーション、メモリスキャン、ポインタ逆参照、厳格なアンチデバッグ緩和策。

  • 🔌 動的な拡張性: ホットリロード可能なB-Skeletonプラグインと宣言的な WorkflowContract パイプライン。

36ドメインのツールカタログ全体を表示 ↗

アーキテクチャとパフォーマンス

[!TIP] コンテキスト効率のベンチマーク: 組み込みツールスキーマの初期化デルタ(Claudeサーバー側のカウント): search ≈ 3.0Kトークン vs 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 ToolAnnotations: すべてのツールはセマンティックアノテーション (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) を保持しており、AIオーケストレーターが呼び出し前にツールの安全性と副作用について推論できるようにします。

レジストリスナップショット

以下の組み込みサーフェスはランタイムレジストリから生成され、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

  • 注: このスナップショットはランタイムレジストリから生成されています。手動でカウントを編集しないでください。

ツールリファレンス全体を表示 ↗

プロジェクト統計

Starの履歴

Activity

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