tools-mcp-bridges
Expose CLI security tools to an AI agent through MCP servers — mcp-kali-server generic terminal bridge, MetasploitMCP, pentestMCP Docker bundle, mcp-security-hub, single-tool nmap/nuclei servers. Load when setting up agent-driven tooling on Kali or wiring a new tool into MCP. Signals: mcpServers con
v2026.10.14-ee0e0c53 installs+3 in 7 days27 StarsMITsynced 22 hours ago
Install
No NotHoly CLI yet? Install it first.
$ curl -fsSL https://notholy.com/install.sh | sh$ notholy skills install noorqureshi/tools-mcp-bridgesWrites to ~/.notholy/skills after checking the signature and the SHA-256.
SignatureSigned, ed25519
Package4e99cddd…39996cc7
4e99cddd3639…e85e39996cc71 file · 2.3 KBScanLow1 finding
- Links to outside domains
Sourcegithub.com/NoorQureshi/security-skills/tree/main/skills/tools/tools-mcp-bridges@ee0e0c5
On this page
When it applies
You're setting up an agent-driven workflow and need CLI tools (nmap, nuclei, sqlmap, hashcat,
gobuster, Metasploit…) callable as MCP tools instead of raw shell. This is infrastructure, not
authorization: registering a tool over MCP never widens scope — tradecraft-scope-roe and
scope.txt still gate every call. For Burp specifically, see tools-burp-suite; for attacking MCP
servers themselves, ai-mcp-security.
Why it works
MCP wraps a tool's CLI behind typed tool definitions, so the agent gets structured parameters and output instead of scraping terminal text. A generic terminal bridge (mcp-kali-server) covers everything but is unstructured; per-tool servers give safer, typed interfaces at the cost of setup.
Options (pick one per need)
| Option | Install | Tools covered | Best for |
|---|---|---|---|
| mcp-kali-server (Kali-official) | apt install mcp-kali-server |
Any terminal command (nmap, nxc, curl, gobuster…) | General-purpose; CTF/labs |
| MetasploitMCP (Kali-official) | apt install metasploitmcp |
MSF modules/payloads/sessions | MSF-heavy exploitation (tools-metasploit) |
| pentestMCP (Docker bundle) | docker run -d -p 8080:8080 ramkansal/pentestmcp |
20+: nmap, nuclei, ZAP, sqlmap, ffuf, nikto, gobuster, subfinder, httpx | One-container everything |
| mcp-security-hub (modular) | per-module pip installs | nmap, Ghidra, nuclei, sqlmap, hashcat | Enable only what you need |
| hexstrike-ai (Kali-official) | apt install hexstrike-ai |
150+ tools, multi-agent orchestration | Large-scale automation |
| Single-tool servers | npm/pip per project | one tool each (e.g. nmap-mcp-server, nuclei-mcp) | Minimal footprint |
Method
- Generic terminal bridge (start here on Kali):
bash kali-server-mcp --port 5000 # API side; runs any terminal command mcp-server --server http://localhost:5000 # MCP client-facing side - Metasploit:
metasploitmcp --transport stdio(preferred) or--transport http --port 8085. The invocation discipline intools-metasploitstill applies underneath (one-shot-x,;exit, port checks). - Docker bundle:
docker pull ramkansal/pentestmcp && docker run -d -p 8080:8080 ramkansal/pentestmcp, then register{"url": "http://localhost:8080/mcp"}in the client'smcpServers. - Register stdio servers in the client config, e.g.:
json { "mcpServers": { "kali-server": { "command": "kali-server-mcp", "args": ["--port", "5000"] }, "metasploit-mcp": { "command": "metasploitmcp", "args": ["--transport", "stdio"] } } } - Verify before relying on it: list the exposed tools and run one harmless call (e.g. a version check) against a lab target before pointing anything at a real engagement.
Gotchas
- A terminal bridge is arbitrary command execution — bind to localhost only, never expose the port on a network interface, and treat the bridge host as compromised-adjacent.
- Community MCP servers are supply chain — audit or pin versions before installing; a malicious tool server sees every command and result. Prefer Kali-official packages when they exist.
- Scope still applies — a registered scanner makes it easier to fire out-of-scope requests,
not more allowed. Keep
scope.txtloaded and check targets against it before every call. - Container bundles run as root with mounted sockets — pentestMCP's Docker has full tool capability; don't mount engagement data you can't afford to leak into it.
- Tool availability ≠ tool correctness — the server reports what its manifest claims; confirm
the underlying binary exists and is the expected version (
nmap --version, etc.).
Verify success
The MCP client lists the server's tools, a harmless invocation returns sane structured output, and every subsequent call is logged against an in-scope target in the engagement workspace.
References
Kali blog on MCP/LLM integration; Wh0am123/MCP-Kali-Server; GH05TCREW/MetasploitMCP; ramkansal/pentestMCP; FuzzingLabs/mcp-security-hub; 0x4m4/hexstrike-ai.
Portions adapted from reverse-skill by zhaoxuya520, MIT License.
Files in this version
- SKILL.md4.9 KB
Permissions
| Permission | Declared | Found by the scan |
|---|---|---|
| Reads files | No | No |
| Writes files | No | No |
| Runs shell commands | Yes | Yes |
| Uses the network | Yes | Yes |
| Uses connectors | Yes | Yes |
| Drives a browser | No | No |
Scan findings
Reviewed on Nov 13, 2026
- InfoLink · Links to outside domains
A clean scan lowers the risk but does not prove a package is safe. Read what you install.
| Version | Published | Commit | SHA-256 | Signature | Permission change |
|---|---|---|---|---|---|
| v2026.10.14-ee0e0c5 | Nov 13, 2026 | ee0e0c5 | 4e99cddd | Signed | – |
More from NoorQureshi
All from this publisherMore in AI, agents and MCP
See the category- fal-assetsrehan-remade/fal-assets5
- ai-system-prompt-leakagenoorqureshi/ai-system-prompt-leakage4
- ai-prompt-injectionnoorqureshi/ai-prompt-injection4
- testing-prompt-injection-in-rag-pipelinesmukul975/testing-prompt-injection-in-rag-pipelines4
- implementing-llm-guardrails-for-securitymukul975/implementing-llm-guardrails-for-security4
- defending-llms-with-guardrailsmukul975/defending-llms-with-guardrails4
Ask anything your scope allows.
Create an account, add credits and ask the first question in the chat or the terminal.
- 1/3
Create the account
Individual or company. You can switch to a company later without losing balance or keys.
IndividualCompany - 2/3
Add credits
By card. Pay per token, no subscription.
$5.00minimum deposit - 3/3
Ask
In the chat, or install the CLI and run notholy login in your terminal.
$ notholy login