jshookmcp

环境要求

• Node.js 环境（项目通过 npx 运行，无需全局安装）
• 支持 MCP 的客户端，如 Claude Desktop 或 Cursor
• 可编辑的客户端配置文件 claude_desktop_config.json
• （可选）完整功能需 ONNX、Z3、Binaryen、Camoufox、Playwright 等运行时

安装与启动步骤

1. 1确认 Node.js 环境

   项目基于 Node.js/TypeScript，通过 npx 直接运行，先确认本机已安装 Node.js 与 npm。

   node -v

   复制

2. 2配置 MCP 客户端

   在 claude_desktop_config.json 的 mcpServers 中加入 jshook 条目，使用 npx 拉取并运行。

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

   复制

3. 3重启客户端生效

   保存配置文件后重启 Claude Desktop / Cursor，客户端会以 stdio 方式拉起 jshook 服务进程。

关键配置

如何确认成功

客户端中能看到 jshook 工具，调用 coverage_report 查看当前会话激活的工具域。

常见问题

注意事项

• 无需全局安装，直接在 MCP 客户端配置里用 npx 运行即可。
• 对外暴露 HTTP 传输前必须先设置 MCP_AUTH_TOKEN，生产部署请参考官方安全与生产指南。
• HTTP 传输支持多会话复用，并在重连后恢复浏览器附着、覆盖与工具激活状态。
• proxy_start 会在需要时自动生成本地 HTTPS 拦截 CA。