@jshookmcp/jshook

English | 中文

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

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

• 📖 ドキュメントを読む

• 🚀 はじめに

• ⚙️ 設定

• 📚 ツールリファレンス

🚀 クイックスタート

グローバルにインストールすることなく、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ドメインのツールカタログ全体を表示 ↗

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

• 段階的なツール検出: 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の履歴