中文 · Русский (RU)

🧠 pentool-mcp-server

MCP 服务器，用于 Pentool —— 本地 AI 助手，助力 Web 渗透测试

一个自包含的 stdio JSON-RPC 2.0 服务器，为任何 MCP 客户端（尤其是 Pentool）带来 AI 能力（BYO-LLM：选择检查项、绕过 WAF、发现非明显端点）。通过 uv 一条命令安装。

为何单独打包

MCP 是连接 LLM 模型与工具的开放协议。pentool-mcp-server 将 Pentool 的 MCP 层封装为可复用的 PyPI 包：本地 stdio 附加，无网络，无端口，秒级安装，无重量级依赖。

Related MCP server: pentestMCP

🔗 专为 Pentool 打造

此服务器是 Pentool 的 MCP 组件，Pentool 是一个专业的 Web 安全测试终端（兼容 Burp 的代理、扫描器、爬虫、入侵器——全部在 TUI 中）。它为 Pentool 的 AI 提供能力：

• 🎯 针对具体目标选择相关的 扫描检查项；

• 🛡 WAF 绕过 / 载荷建议；

• 🕷 在爬虫爬取过程中发现 非明显端点。

尝试完整栈：uv tool install "pentool[ai]" → pentool ai setup → pentool。

⚡ 快速开始（uv）

# Install uv (if not present): https://docs.astral.sh/uv/
curl -LsSf https://astral.sh/uv/install.sh | sh

# Standalone — just the MCP server
uv tool install pentool-mcp-server
pentool-mcp-server --version

# Or together with Pentool and its AI extras
uv tool install "pentool[ai]"

健康检查（stdio）：

echo '{"jsonrpc":"2.0","id":1,"method":"ping"}' | pentool-mcp-server
# → {"jsonrpc": "2.0", "id": 1, "result": {"status": "ok"}}

uv 是标准安装路径——隔离环境，与 Pentool 自身的安装方式完全一致。它使服务器远离系统 Python。

🚀 在 VPS / 容器中部署

服务器不开放任何端口，作为本地子进程运行——在任何主机上均安全。使用 uv 可使其远离系统 Python：

uv tool install pentool-mcp-server

完整用户指南——docs/GUIDE.md。俄语版——README.ru。

🧩 MCP 工具

🔒 安全性

• 默认无网络。 pentool-mcp-server 仅在本地进程内监听 stdio（标准输入→标准输出）。外部访问不可能——既不能从其他进程，也不能从其他主机。

• 未经认证，请勿通过 TCP/0.0.0.0 暴露。 如果在外部网络端口上运行，任何能够写入标准输入/端口的人都可以调用 tools/call generate（资源消耗 + 向 LLM 发送目标数据）。MCP 没有内置认证——请绑定到 127.0.0.1 并通过防火墙进行防护。

• 目标隐私。 数据（URL、载荷）仅在连接外部 LLM 提供商时才会离开主机；使用本地 GGUF 模型时，流量保留在机器上。

更多——docs/GUIDE.md。

🗺 路线图

• stdio JSON-RPC 2.0 服务器（initialize / tools/list / tools/call / ping）

• generate、health、configure 工具

• 在 model.py 中实现真正的 LLM 运行器（llama-cpp-python）

• 可选的 TCP 模式，带 HMAC 认证

📄 许可证

AGPL-3.0 —— 与 Pentool 相同的许可证。

支持 / 缺陷报告： issues · 专为 Pentool 设计 · 用户指南