Vluggy Lite-专注于CTF的AI黑客助手
一个轻量级的MCP服务器，将Claude Desktop变成一个 CTF求解机 与：
- 🧠 CTF大脑：模式匹配、基元检测和求解策略
- 🔧 25+安全工具：nmap、sqlmap、feroxbuster、hydra、john、hashcat等
- 📚 知识库：深度抓取的CTF文章、黑客技巧、PayloadsAllTheThings
- 🔐 加密解码器：Base64，十六进制，ROT13，凯撒密码暴力破解
建筑
Claude Desktop
│
▼
┌─────────────┐ ┌─────────────┐
│ mcp-shim │────▶│ mcp-http │──┬──▶ kali-mcp (tools)
│ (Python) │ │ (FastAPI) │ ├──▶ planner-api
└─────────────┘ └─────────────┘ ├──▶ dcipher
└──▶ CTF Brain
│
┌────┴────┐
│ Supabase │ (Knowledge Base)
└─────────┘快速开始
先决条件
- Python 3.10+
- 克劳德桌面版
- （可选） Supabase 知识库说明
安装
窗户：
powershell -ExecutionPolicy Bypass -File setup.ps1Linux/Mac：
chmod +x setup.sh && ./setup.sh启动服务
docker-compose up --build -d配置Claude桌面
添加 %APPDATA%\Claude\claude_desktop_config.json:
{
"mcpServers": {
"vluggy-lite-mcp": {
"command": "C:\\Users\\YOUR_USER\\vluggy-lite\\mcp-shim\\.venv\\Scripts\\python.exe",
"args": ["C:\\Users\\YOUR_USER\\vluggy-lite\\mcp-shim\\server.py"],
"env": {
"VLUGGY_HTTP_URL": "http://localhost:5001",
"PLANNER_URL": "http://localhost:5101",
"VLUGGY_API_KEY": "your-api-key-here",
"VLUGGY_VOLUME_DIR": "C:\\Users\\YOUR_USER\\vluggy-lite\\volumes\\files"
}
}
}
}MCP工具
安全工具
| 工具 | 说明 | 示例 |
|---|---|---|
exec_tool | 运行任何Kali工具 | exec_tool("nmap", "-sV 10.10.10.1") |
plan_exec | 基于目标类型的自动计划 | plan_exec("web", "http://target.com") |
dcipher | 解码/编码密码 | dcipher("brute", "caesar", "Uryyb") |
tools | 列出可用工具 | tools() |
CTF脑工具
| 工具 | 说明 | 示例 |
|---|---|---|
ctf_analyze | 分析挑战，制定战略 | ctf_analyze("Login form gives MySQL error") |
ctf_search | 搜索知识库 | ctf_search("PHP deserialization") |
ctf_template | 获取漏洞利用代码模板 | ctf_template("pwn", "buffer_overflow") |
CTF大脑
CTF Brain体现了 CTF心态:
- 一切都是故意的 -如果有什么东西看起来很奇怪，那就是线索
- 寻找最小的裂缝 -找出唯一的弱点
- 像解谜者一样思考 -逻辑战胜暴力
- 减少到已知图元 -映射到已知的漏洞利用模式
示例用法
User: "The website has a login form. When I enter a single quote, I get a MySQL error."
Claude (via ctf_analyze):
- Category: web (confidence: 0.85)
- Primitives: ["sqli"]
- Tools: ["sqlmap", "burpsuite"]
- Kill chain: ["reconnaissance", "identify_vulnerability", "craft_payload", ...]
- Hints:
- "Try ' OR '1'='1' -- "
- "Check for error messages revealing DB structure"
- Attack vectors:
- "Run sqlmap with --dbs to enumerate databases"知识库设置（可选）
要在CTF报告上启用语义搜索，请执行以下操作：
1.创建Supabase项目
- 首选 网站 supabase.com 并创建一个项目
- 获取您的项目URL和匿名密钥
2.运行架构
在Supabase SQL编辑器中，运行以下内容：
ingestor/app/supabase_schema.sql3.配置环境
创建 .env:
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_KEY=your-anon-key
VLUGGY_API_KEY=your-random-api-key
GITHUB_TOKEN=your-github-token # Optional, for higher API limits4.运行Ingestor
# Ingest all sources (takes time)
docker-compose --profile ingest up vluggy-lite-ingestor
# Or ingest specific sources
docker-compose run vluggy-lite-ingestor python ingest.py --source gtfobins
docker-compose run vluggy-lite-ingestor python ingest.py --ctftime --max-pages 50
docker-compose run vluggy-lite-ingestor python ingest.py --github swisskyrepo/PayloadsAllTheThings可用的安全工具
| 类别 | 工具 |
|---|---|
| 扫描 | nmap、masscan、whatweb、nikto |
| 引信 | gobuster、ffuf、feroxbuster、dirsearch、wfuzz |
| 漏洞利用 | sqlmap、hydra、crackmapexec |
| 密码 | john、hashcat、hashid |
| 网络 | tshark、tcpdump、curl、wget |
| 加密 | base64，十六进制，rot13，凯撒（通过dcipher） |
港口
| 服务 | 端口 |
|---|---|
| HTTP网关 | 5001 |
| 规划师API | 5101 |
| Dcipher | 5601 |
| 卡利集装箱 | 8766 |
故障排除
服务未启动？
docker-compose logs -f克劳德无法连接？
- 确保Docker服务正在运行：
docker ps - 检查mcp垫片真空度：
mcp-shim/.venv/Scripts/pip list - 验证中的配置路径
claude_desktop_config.json
CTF大脑不工作？
- 检查进气管/应用程序模块是否存在
- 如果使用搜索，请验证Supabase凭据
发展
# Rebuild specific service
docker-compose build vluggy-lite-http
# View logs
docker-compose logs -f vluggy-lite-http
# Test CTF Brain locally
cd ingestor/app
python ingest.py --test许可证
麻省理工学院