使用说明
最重要的MCP服务器
一种模型上下文协议(MCP)服务器,为受控环境中的教育目的提供安全测试工具。
⚠️ 重要法律通知
此软件仅用于教育目的
- 仅在您拥有或有明确书面许可进行测试的系统上使用
- 在大多数司法管辖区,未经授权的渗透测试是非法的
- 开发人员对滥用此软件不承担任何责任
- 始终遵守当地法律法规
目的
该MCP服务器为AI助手提供了一个安全接口,通过行业标准的安全工具对授权系统进行渗透测试和安全评估。
特性
当前实施情况
nmap_scan-具有多种扫描类型(快速、完整、隐形、ping)的网络发现和端口扫描nikto_scan-Web服务器漏洞扫描以查找配置错误和已知问题sqlmap_test-web应用程序参数的自动SQL注入测试wpscan_scan-使用插件/主题枚举进行WordPress特定漏洞扫描dirb_scan-目录和文件暴力破解隐藏的web内容发现searchsploit_search-在漏洞利用数据库中搜索已知漏洞ping_test-基本连接测试,以验证目标是否可达
先决条件
- 启用MCP工具包的Docker桌面
- Docker MCP CLI插件(
docker mcp命令) - 测试目标系统的授权
- 理解道德黑客原则
安装
请参阅下面第2节中的分步说明。
使用示例
在Claude Desktop中,您可以问:
- “使用nmap快速扫描192.168.1.1”
- “与nikto对抗http://testsite.local端口80“
- “测试http://example.com/page?id=1用于SQL注入”
- “扫描http://wordpress-site.com对于使用wpscan的易受攻击的插件“
- “在上搜索隐藏目录http://example.com使用dirb”
- “在exploitdb中搜索apache 2.4漏洞”
- “10个数据包的Ping测试8.8.8.8”
建筑
Claude Desktop → MCP Gateway → Pentest MCP Server → Security Tools
↓
(nmap, nikto, sqlmap,
wpscan, dirb, searchsploit)
发展
本地测试
# Run directly (not recommended for production)
python3 pentest_server.py
# Test MCP protocol
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | python3 pentest_server.py
添加新工具
- 在Dockerfile中安装该工具
- 如果需要,添加消毒功能
- 在pentest_server.py中创建一个新的@mcp.tool()函数
- 用新的工具名称更新目录条目
- 重建Docker镜像
故障排除
工具未出现
- 验证Docker镜像构建成功:
docker images | grep pentest - 检查目录和注册表文件的格式是否正确
- 确保Claude Desktop配置包括自定义目录
- 完全重新启动克劳德桌面
权限错误
- 验证容器是否具有适当的网络工具功能
- 检查非root用户是否具有执行权限
- 某些工具可能需要特定的网络配置
命令超时
- 如果需要,增加代码中的超时值
- 考虑将大型扫描分解为较小的目标
- 一些工具(sqlmap、wpscan)可能需要几分钟的时间
安全注意事项
- 所有命令都经过消毒,以防止注射攻击
- 以非root用户身份运行,所需功能最少
- 输出被截断以防止数据过度暴露
- 没有记录凭据或敏感数据
- 工具在隔离的Docker容器中运行
- Docker网络控制的网络访问
道德使用指南
- 授权:测试前务必获得书面许可
- 范围:保持在商定的测试范围内
- 文档:保存所有测试活动的详细日志
- 披露:负责任地向系统所有者报告调查结果
- 合规:遵守适用的法律和行业标准(如PCI-DSS、GDPR)
许可证
MIT许可证-详见文件
免责声明
此工具“按原样”提供,不提供任何形式的保修。作者和贡献者不对本软件造成的任何误用或损坏负责。用户全权负责确保其使用符合所有适用的法律法规。