渗透测试工具服务器

一个为教育目的提供安全测试工具的模型上下文协议(MCP)服务器,适用于授权系统的渗透测试和安全评估。

  • by billycuesta
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 billycuesta/kali-mcp

使用说明

最重要的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

添加新工具

  1. 在Dockerfile中安装该工具
  2. 如果需要,添加消毒功能
  3. 在pentest_server.py中创建一个新的@mcp.tool()函数
  4. 用新的工具名称更新目录条目
  5. 重建Docker镜像

故障排除

工具未出现

  • 验证Docker镜像构建成功: docker images | grep pentest
  • 检查目录和注册表文件的格式是否正确
  • 确保Claude Desktop配置包括自定义目录
  • 完全重新启动克劳德桌面

权限错误

  • 验证容器是否具有适当的网络工具功能
  • 检查非root用户是否具有执行权限
  • 某些工具可能需要特定的网络配置

命令超时

  • 如果需要,增加代码中的超时值
  • 考虑将大型扫描分解为较小的目标
  • 一些工具(sqlmap、wpscan)可能需要几分钟的时间

安全注意事项

  • 所有命令都经过消毒,以防止注射攻击
  • 以非root用户身份运行,所需功能最少
  • 输出被截断以防止数据过度暴露
  • 没有记录凭据或敏感数据
  • 工具在隔离的Docker容器中运行
  • Docker网络控制的网络访问

道德使用指南

  1. 授权:测试前务必获得书面许可
  2. 范围:保持在商定的测试范围内
  3. 文档:保存所有测试活动的详细日志
  4. 披露:负责任地向系统所有者报告调查结果
  5. 合规:遵守适用的法律和行业标准(如PCI-DSS、GDPR)

许可证

MIT许可证-详见文件

免责声明

此工具“按原样”提供,不提供任何形式的保修。作者和贡献者不对本软件造成的任何误用或损坏负责。用户全权负责确保其使用符合所有适用的法律法规。