docs: show explicit MCP host selection on macOS

This commit is contained in:
jhuang-tw
2026-08-18 00:20:44 -07:00
parent e7c3394241
commit dce8138463
+22 -6
View File
@@ -45,7 +45,7 @@ python3 -m pipx ensurepath
| Ghidra | `brew install ghidra` or `brew install --cask ghidra` | GitHub release ZIP | Formula/cask availability may vary. | | Ghidra | `brew install ghidra` or `brew install --cask ghidra` | GitHub release ZIP | Formula/cask availability may vary. |
| IDA Pro | manual app install | — | Usually under `/Applications/IDA Professional*.app`. | | IDA Pro | manual app install | — | Usually under `/Applications/IDA Professional*.app`. |
| BurpSuite | `brew install --cask burp-suite` | manual jar / installer | Load `burp-mcp-full` extension manually. | | BurpSuite | `brew install --cask burp-suite` | manual jar / installer | Load `burp-mcp-full` extension manually. |
| jshookmcp | `npx -y @jshookmcp/jshook@0.3.4` | MCP config command | Requires Node/npm/npx. | | jshookmcp | `npx -y @jshookmcp/jshook@0.3.4` | MCP config command | Requires Node/npm/npx and explicit MCP registration. |
| anything-analyzer | project clone + `pnpm install` | custom local service | Register its MCP endpoint. | | anything-analyzer | project clone + `pnpm install` | custom local service | Register its MCP endpoint. |
| nuclei | `brew install nuclei` | GitHub release / Go install | Optional security scanner. | | nuclei | `brew install nuclei` | GitHub release / Go install | Optional security scanner. |
| SecLists | Git clone | — | Usually clone to `~/tools/SecLists`. | | SecLists | Git clone | — | Usually clone to `~/tools/SecLists`. |
@@ -100,6 +100,16 @@ If the service uses a custom port or token, update your Agent client's MCP confi
## MCP setup notes ## MCP setup notes
The core bootstrap is client-neutral by default. It **does not write** `~/.claude/mcp.json` or `~/.codex/config.toml` unless an MCP host is explicitly selected. For MCP capabilities, use one of:
```bash
--mcp-host=claude
--mcp-host=codex
--mcp-host=both
```
Without an explicit host, the bootstrap may prepare the runtime but reports the MCP capability as `registration-required`. Override the explicit adapter paths with `CLAUDE_MCP_CONFIG` or `CODEX_CONFIG_PATH` when needed.
### BurpSuite MCP ### BurpSuite MCP
Build the extension: Build the extension:
@@ -167,12 +177,18 @@ From the repository root, list the same core capability names as the Windows Pow
The generic bootstrap is compatible with the system `/bin/bash` shipped by macOS (Bash 3.2); Homebrew Bash is not required. The generic bootstrap is compatible with the system `/bin/bash` shipped by macOS (Bash 3.2); Homebrew Bash is not required.
Install or configure supported capabilities with the generic Bash bootstrap: Install ordinary capabilities without selecting an Agent client:
```bash ```bash
/bin/bash skills/scripts/bootstrap-reverse.sh jadx apktool frida /bin/bash skills/scripts/bootstrap-reverse.sh jadx apktool frida
/bin/bash skills/scripts/bootstrap-reverse.sh jshookmcp anything-analyzer ```
/bin/bash skills/scripts/bootstrap-reverse.sh burpsuite-mcp
For MCP registration, select the target client explicitly:
```bash
/bin/bash skills/scripts/bootstrap-reverse.sh jshookmcp --mcp-host=codex
/bin/bash skills/scripts/bootstrap-reverse.sh anything-analyzer --mcp-host=claude
/bin/bash skills/scripts/bootstrap-reverse.sh burpsuite-mcp --mcp-host=both
``` ```
Refresh the local tool index only: Refresh the local tool index only:
@@ -188,7 +204,7 @@ skills/tool-index.md
skills/tool-index.json skills/tool-index.json
``` ```
`bootstrap-reverse.sh` installs/configures supported capabilities where possible on macOS, using Homebrew, `pipx`, `npm`, GitHub releases, and MCP registration. `refresh-tool-index.sh` is detection-only. Manual-only tools such as IDA Pro and BurpSuite still require local app installation and app-specific setup. `bootstrap-reverse.sh` installs or prepares supported capabilities where possible on macOS using Homebrew, `pipx`, `npm`, and GitHub releases. MCP client registration occurs only when `--mcp-host=...` is explicit. `refresh-tool-index.sh` is detection-only and discovers supported MCP registrations without choosing a default Agent client. Manual-only tools such as IDA Pro and BurpSuite still require local app installation and app-specific setup.
## Validation checklist ## Validation checklist
@@ -211,4 +227,4 @@ bash skills/scripts/refresh-tool-index.sh
- GUI app paths vary by edition and version. Do not hard-code IDA or Burp paths unless you verified them locally. - GUI app paths vary by edition and version. Do not hard-code IDA or Burp paths unless you verified them locally.
- Some security tools are Linux-first. Prefer Homebrew formulae first, then GitHub releases, then source builds. - Some security tools are Linux-first. Prefer Homebrew formulae first, then GitHub releases, then source builds.
- iOS analysis may require additional signing, device, and jailbreak-specific setup; keep those steps in a dedicated mobile reverse Skill rather than this generic platform page. - iOS analysis may require additional signing, device, and jailbreak-specific setup; keep those steps in a dedicated mobile reverse Skill rather than this generic platform page.