anything-analyzer-mcp

anything-analyzer 的 MCP/CLI/headless/MITM 使用心得总表。含抓包、逆向、启动、验活、路由边界。 触发方式:Hermes 路由名 `devops/anything-analyzer-mcp`、通用 slash command `/skill devops/anything-analyzer-mcp`

SKILL.md

GitHub

anything-analyzer MCP

何时用

命中下列意图,先载此 skill:

  • 用户提 anything-analyzer / aa
  • 需要抓包、逆向 API、看请求明细、跑 AI 分析
  • 需要 AA 的 MCP、CLI、headless、MITM
  • 需要“无 Electron/UI”地把 AA 当后端
  • 需要让外部浏览器经 MITM 进 session

若任务是“当前真实 Chrome / 现成登录态 / 当前页面直控”,不要默认只靠 AA;先结合 badboy-br-aa-routing 分流。

总结论

AA 现有 3 条面:

  1. MCP 面:http://localhost:23816/mcp
  2. MITM 面:127.0.0.1:8888
  3. browser-ui 面:仅在桌面 UI/backend 存在时可用

核心边界:

  • external 模式:负责 MITM 抓包与后续分析;不负责页面内控制
  • browser-ui 模式:才有 CDP / tabs / screenshot / hooks / storage 的完整页面内能力
  • 用户明确禁止 Electron/UI 时,默认走 headless + external

起手检查

先判用户要哪类:

  • 只要抓包/逆向/AI 分析,不要桌面窗口 → headless + external
  • 要控制 AA 内嵌浏览器 / CDP / screenshot → browser-ui
  • 要看用户真实 Chrome 当前页 → 先走 badboy/browser-harness/真实 Chrome 路线,AA 只做后端分析或外部抓包

启动方式

纯后端,禁 UI

cd ~/anything-analyzer
pnpm build:cli
AA_HEADLESS=1 AA_CONFIG_DIR="$HOME/Library/Application Support/anything-analyzer" node ./out/main/nodeHeadless.mjs

oneshot 验活:

cd ~/anything-analyzer
pnpm build:cli
AA_HEADLESS=1 AA_CONFIG_DIR="$HOME/Library/Application Support/anything-analyzer" node ./out/main/nodeHeadless.mjs --oneshot

成功判据:

  • 有 [MCP Server] Listening on http://localhost:23816/mcp
  • 有 [MitmProxy] Listening on port 8888
  • JSON 含 "mitmEnabled":true

桌面 UI 路径

仅在用户明确要 AA 桌面界面时才可用。默认不要自动 open -a。

MCP 信息

  • URL: http://localhost:23816/mcp
  • Transport: StreamableHTTP
  • 必要请求头:
    • Authorization: Bearer <authToken>
    • Accept: application/json, text/event-stream
  • 配置文件:
    • ~/Library/Application Support/anything-analyzer/mcp-server-config.json
  • 真实字段:
    • enabled
    • port
    • authEnabled
    • authToken

MITM 信息

  • 默认端口:8888
  • 配置文件:
    • ~/Library/Application Support/anything-analyzer/mitm-proxy-config.json
  • MITM 成功不等于 CA 已装进系统信任;是否真可拦 HTTPS 仍取决于浏览器/系统是否信任该 CA

验活顺序

1. 先验构建产物不含 Electron/UI

cd ~/anything-analyzer
pnpm build:cli
node -e "const fs=require('fs'); const s=fs.readFileSync('out/main/nodeHeadless.mjs','utf8'); for (const x of ['electron','BrowserWindow','ipcMain','src/main/session/session-manager.ts','src/main/runtime/bootstrap.ts']) console.log(x+':', s.includes(x));"

期望全 false。

2. 再验 oneshot

AA_HEADLESS=1 AA_CONFIG_DIR="$HOME/Library/Application Support/anything-analyzer" node ./out/main/nodeHeadless.mjs --oneshot

3. 再验 MCP initialize

curl -i -X POST http://localhost:23816/mcp \
  -H 'Authorization: Bearer <authToken>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"debug","version":"1.0"}}}'

成功判据:

  • HTTP 200
  • 响应头有 mcp-session-id
  • body 返回 initialize 结果

4. 若要确认 MITM 真起

看启动日志是否有:

  • [MitmProxy] Listening on port 8888

oneshot JSON 应含:

  • "mitmEnabled":true

常用工具面

Session 管理

  • list_sessions
  • create_session(name, targetUrl)
  • start_capture(sessionId, mode?)
  • pause_capture(sessionId)
  • resume_capture(sessionId)
  • stop_capture(sessionId)
  • delete_session(sessionId)

数据面

  • get_requests(sessionId)
  • filter_requests(sessionId, filters)
  • get_request_detail(requestId)
  • get_hooks(sessionId)
  • get_storage(sessionId)

AI 分析面

  • run_analysis(sessionId, purpose?, selectedSeqs?)
  • get_reports(sessionId)
  • chat_followup(sessionId, message)

browser-ui only

  • navigate(url)
  • browser_back
  • browser_forward
  • browser_reload
  • create_tab(url?)
  • close_tab(tabId)
  • list_tabs
  • browser_screenshot
  • cdp_send_command(method, params?)

抓包工作流

外部浏览器抓包,禁 UI

适用:

  • 用户真实 Chrome / BadBoyBrowser / 其它浏览器已开
  • 只需抓请求、分析协议,不需 AA 自己开窗口

流程:

  1. 起 AA headless
  2. create_session
  3. start_capture(sessionId, mode="external")
  4. 让外部浏览器走 127.0.0.1:8888
  5. 完成操作
  6. stop_capture(sessionId)
  7. filter_requests / get_request_detail
  8. run_analysis(purpose="reverse-api")

要点:

  • external 不依赖 AA tab
  • external 不提供页面内控制
  • 对某些 Hermes relay / browser-harness 页面,external 可能完全抓不到流量;即便系统代理已改到 127.0.0.1:8888、AA 8888/23816 监听正常、session 也成功 start_capture,抓到的仍可能只有 AA 自己的 MCP 请求而没有目标站点流量。若 filter_requests / get_requests 持续为空,不要继续假设 MITM 已接上该页面。
  • 遇到上述情况,优先回退到页面内取证:在目标 userscript/页面里埋 fetch/XMLHttpRequest hook,仅记录目标 API(如 /tile-api/*)的 request/response 摘要,再由 Hermes/AA 做离线分析。
  • 若用户要求“你替我接上 AA MITM”,可直接在宿主机把系统代理指向 127.0.0.1:8888,然后重载 AA headless 再复测抓包;在 macOS 上可用:
    • networksetup -setwebproxy 'Wi-Fi' 127.0.0.1 8888
    • networksetup -setsecurewebproxy 'Wi-Fi' 127.0.0.1 8888
    • networksetup -setwebproxystate 'Wi-Fi' on
    • networksetup -setsecurewebproxystate 'Wi-Fi' on
  • 若 AA 通过 launchd 长驻,补充在 ~/Library/LaunchAgents/com.anything-analyzer.dev.plist 写入 http_proxy / https_proxy / HTTP_PROXY / HTTPS_PROXY 到 http://127.0.0.1:8888,再执行:
    • launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.anything-analyzer.dev.plist 2>/dev/null || true
    • launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.anything-analyzer.dev.plist
    • launchctl kickstart -k gui/$(id -u)/com.anything-analyzer.dev
  • 适合“真实浏览器做人,AA收流量”

browser-ui 抓包

适用:

  • 需要 AA 内部页面控制
  • 需要 CDP / screenshot / hooks / storage

流程:

  1. create_session
  2. start_capture(sessionId, mode="browser-ui")
  3. navigate
  4. 页面交互
  5. stop_capture
  6. 查询与分析

逆向 API 工作流

最短路径:

  1. create_session
  2. start_capture
  3. 触发目标行为
  4. stop_capture
  5. filter_requests(domain=..., contentType='json')
  6. get_request_detail
  7. run_analysis(purpose='reverse-api')
  8. chat_followup('列认证链/签名算法/重放顺序')

建议追问:

  • 列所有认证相关请求
  • 列请求依赖顺序
  • 列 header/body 中签名字段
  • 推测重放所需最小字段集
  • 列可疑 crypto / nonce / timestamp 流程

MCP 协议坑

必须带 Accept

若缺:

  • Accept: application/json, text/event-stream

则常见为握手失败或客户端报 handshaking error。

token 字段不是 token

真实字段名:

  • authToken

不是:

  • token

initialize 成功不等于 tools/list 一定成功

已知坑:

  • 某些版本 tools/list 会报 _zod

但:

  • initialize
  • resources/list
  • resources/read

仍可能可用。

应对:

  • 不要卡死在客户端“列工具失败”
  • 直接看 src/main/mcp/mcp-server.ts 中注册了哪些 tool/resource
  • 或直接手工 POST 调用已知方法

Headless / CLI 心得

pnpm dev 不是总有

CLI-only 打包态可能没有 pnpm dev。

若报:

  • ERR_PNPM_RECURSIVE_EXEC_FIRST_FAIL Command "dev" not found

改走:

  • pnpm build:cli
  • node ./out/main/nodeHeadless.mjs

launchd / LaunchAgent 常见双坑

若 anything-analyzer (http) 手动前台能起,后台 LaunchAgent 却失败,先查两项:

  1. plist 还在跑旧命令 pnpm dev
  2. launchd 用的是另一套 Node,致 better-sqlite3 ABI 不匹配

现场判法:

launchctl list | grep -i anything-analyzer || true
launchctl print gui/$(id -u)/com.anything-analyzer.dev | sed -n '1,160p'
/usr/local/bin/node -p "process.execPath + ' ' + process.versions.modules + ' ' + process.version"
/opt/homebrew/bin/node -p "process.execPath + ' ' + process.versions.modules + ' ' + process.version"
cat /tmp/anything-analyzer-stdout.log 2>/dev/null || true
cat /tmp/anything-analyzer-stderr.log 2>/dev/null || true

典型现象:

  • 前台 shell 用 /opt/homebrew/bin/node,如 Node 25,ABI 141
  • LaunchAgent PATH 先命中 /usr/local/bin/node,如 Node 22,ABI 127
  • 于是后台报:
    • better_sqlite3.node was compiled against a different Node.js version

修法:

  • 先按当前目标 Node 重编:
cd ~/anything-analyzer
pnpm config set only-built-dependencies better-sqlite3
pnpm rebuild better-sqlite3
  • 再把 ~/Library/LaunchAgents/com.anything-analyzer.dev.plist 改到明确、单一路径:

    • PATH 以 /opt/homebrew/bin 开头
    • 不再跑 pnpm dev
    • 改跑 pnpm build:cli && AA_HEADLESS=1 ... /opt/homebrew/bin/node ./out/main/nodeHeadless.mjs
    • 环境变量显式写入 AA_HEADLESS=1 与 AA_CONFIG_DIR
  • 最后重载:

launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.anything-analyzer.dev.plist 2>/dev/null || true
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.anything-analyzer.dev.plist
launchctl kickstart -k gui/$(id -u)/com.anything-analyzer.dev

成功判据:

  • launchctl print ... 显示 state = running
  • stdout 日志出现:
    • [MCP Server] Listening on http://localhost:23816/mcp
    • [MitmProxy] Listening on port 8888
  • lsof -nP -iTCP:23816 -sTCP:LISTEN
  • lsof -nP -iTCP:8888 -sTCP:LISTEN

缺 headless 产物

若报:

  • Cannot find module ...nodeHeadless.js
  • Cannot find module ...nodeHeadless.mjs

先做:

  • pnpm build:cli

better-sqlite3 ABI 坑

若报:

  • NODE_MODULE_VERSION 不匹配
  • ERR_DLOPEN_FAILED
  • Could not locate the bindings file

优先修:

cd ~/anything-analyzer
pnpm config set only-built-dependencies better-sqlite3
pnpm rebuild better-sqlite3

随后验:

node -e "const Database=require('better-sqlite3'); const db=new Database(':memory:'); console.log(db.prepare('select 1 x').get().x); db.close()"

node-forge ESM 坑

真实踩坑:

  • 当前 ESM 打包态下,node-forge 运行时常只暴露 default
  • 若源码写 import * as forge from 'node-forge',运行时可出现 forge.pki 空
  • 继而 privateKeyFromPem 崩,MITM 起不来

稳妥写法:

import * as forgeNs from "node-forge";
const forge = (forgeNs as any).default ?? forgeNs;

修后验:

node -e "import * as forgeNs from 'node-forge'; const forge=(forgeNs.default??forgeNs); const keys=forge.pki.rsa.generateKeyPair({bits:512}); const pem=forge.pki.privateKeyToPem(keys.privateKey); const parsed=forge.pki.privateKeyFromPem(pem); console.log(!!parsed && !!parsed.n && !!parsed.e)"

MITM 错误要降级

即便 MITM 失败,也不应阻断 MCP 本体启动。

验收须拆成两层:

  • MCP 可用?
  • MITM 可用?

不要把二者混为一谈。

focused test 仍触发 Electron,多半是 runtime bootstrap 串错分支

真实踩坑:

  • tests/runtime-bootstrap-ipc-path.test.ts 若报 Electron failed to install correctly
  • 往往不是测试 mock 失效,而是 src/main/runtime/bootstrap.ts 仍静态拉进了 Electron 路径

优先查两点:

  1. headless runtime 是否仍在用 SessionManager
    • 错:../session/session-manager
    • 对:../node-session-manager
  2. bootstrap 是否在启动期注入了 IPC 路径提供者
    • 需调用:setIpcPathProvider(options.pathProvider)

推荐修法:

  • createRuntimeContext() 中:
    • setDatabasePathProvider(options.pathProvider) 后立刻接 setIpcPathProvider(options.pathProvider)
    • new SessionManager(...) 改为 new NodeSessionManager(...)

修后先跑最小验证:

cd ~/anything-analyzer
pnpm exec vitest run tests/runtime-bootstrap-ipc-path.test.ts

再跑提交前 focused suite:

cd ~/anything-analyzer
pnpm build:cli
pnpm exec vitest run \
  tests/main/node-headless.test.ts \
  tests/runtime-bootstrap-ipc-path.test.ts \
  tests/runtime-headless-config.test.ts \
  tests/main/release-workflow.test.ts

Electron/UI 禁令下的处置

用户若明确说:

  • 不要 Electron
  • 不要 UI
  • 不要弹窗

则必须:

  • 不自动 open -a 'BadBoy Analyzer'
  • 不自动 open -a 'Anything Analyzer'
  • 不用桌面窗口做“探测”

先止血:

pkill -f 'BadBoy Analyzer|Anything Analyzer|anything-analyzer.*Electron|electron.*anything-analyzer' || true
ps aux | grep -i 'BadBoy Analyzer\|Anything Analyzer\|electron.*anything-analyzer\|anything-analyzer.*electron' | grep -v grep || true

默认路径改为:

  • headless + external

真实浏览器 / 当前页分流

若用户要:

  • 当前页面
  • 真实 Chrome
  • 已登录态
  • Tampermonkey 当前脚本

默认不要只靠 AA。

分流:

  • 直控真实页面 → badboy-browser / browser-harness-real-chrome / computer-use
  • AA 做后端抓包 → start_capture(mode='external')
  • 需要离线分析 → run_analysis / chat_followup

一句话:

  • 人在真实浏览器里操作
  • AA 在后面收包、归档、分析

多平台配置格式

Hermes

anything-analyzer:
  transport: streamableHttp
  url: http://localhost:23816/mcp
  headers:
    Authorization: "Bearer <TOKEN>"

Claude Code

{
  "type": "url",
  "url": "http://localhost:23816/mcp",
  "headers": { "Authorization": "Bearer <TOKEN>" }
}

Windsurf

{
  "serverUrl": "http://localhost:23816/mcp",
  "headers": { "Authorization": "Bearer <TOKEN>" }
}

Codex

[mcp_servers.anything-analyzer]
url = "http://localhost:23816/mcp"

[mcp_servers.anything-analyzer.headers]
Authorization = "Bearer <TOKEN>"

发布/打包经验

若目标是 agent-only:

  • 默认发 CLI 产物,不默认发桌面安装包
  • pnpm build 可 alias 到 build:cli
  • package.json main 指向 headless entry
  • 用 files 白名单裁 tarball

但:

  • 裁发布包,不等于删除仓库 UI 源码
  • 除非用户明确要求,不要直接删 src/renderer/、electron-builder.yml、resources/

推荐验证命令集

cd ~/anything-analyzer
pnpm build:cli
node -e "const fs=require('fs'); const s=fs.readFileSync('out/main/nodeHeadless.mjs','utf8'); for (const x of ['electron','BrowserWindow','ipcMain']) console.log(x+':', s.includes(x));"
node -e "const Database=require('better-sqlite3'); const db=new Database(':memory:'); console.log(db.prepare('select 1 x').get().x); db.close()"
AA_HEADLESS=1 AA_CONFIG_DIR="$HOME/Library/Application Support/anything-analyzer" node ./out/main/nodeHeadless.mjs --oneshot

路由短则

  • 提 AA/MCP/抓包/逆向接口 → 先载此 skill
  • 提 真实 Chrome/当前页面/现成登录态 → 先看 badboy-br-aa-routing
  • 提 禁 UI/别弹窗 → 直接 headless + external
  • 提 CDP/screenshot/tabs → 明示 browser-ui only
  • 提 MITM 不通 → 先查 node-forge、CA、8888 监听、是否信任 CA
  • 提 MCP 不通 → 先查 authToken、Accept、initialize、23816 监听