使用说明
VulnMCP
专业MCP安全培训平台
通过实际利用漏洞学习MCP安全
重要免责声明
VulnMCP包含用于教育目的的故意安全漏洞。
- 不要 在生产环境中部署
- 不要 暴露于不受信任的网络
- 不要 在具有真实数据的系统上使用
- 做 在孤立的学习环境中使用
- 做 实行负责任的披露
- 做 共享知识以提高安全性
特性
- 8渐进式挑战 -从初学者到专家
- MCP特定漏洞 -真实协议利用
- 游戏化学习 -积分、徽章、排行榜
- 智能提示系统 -无剧透的渐进式提示
- 进度跟踪 -监控你的进步
- Docker就绪 -一个启动命令
- 综合文档 -在破解过程中学习
- 漂亮的界面 -终端风格UI
🚀 快速开始
先决条件
- Docker&Docker编写
- Claude Desktop(或任何MCP客户端)
- Git
安装
# 1. Clone the repository
git clone https://github.com/N0V1CHOK/vulnMCP.git
cd vulnmcp
# 2. Start with Docker
docker-compose up -d
# 3. View logs
docker-compose logs -f vulnmcp-server
# 4. Open web interface
open http://localhost:8080
配置Claude桌面
添加到您的 claude_desktop_config.json:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"vulnmcp": {
"command": "docker",
"args": ["exec", "-i", "vulnmcp-server", "python", "-m", "src.server"]
}
}
}
开始黑客攻击!
在克劳德桌面中:
Use the tool: vulnmcp_help
To see all challenges:
vulnmcp_help(action='challenges')
🎯 挑战
| 级别 | 名称 | 难度 | 点数 | 类别 |
|---|---|---|---|---|
| 1 | 刀具参数注入 | ⭐☆☆☆ | 100 | 输入验证 |
| 2 | 资源URI操作 | ⭐☆☆☆ | 150 | 访问控制 |
| 3 | 上下文中毒 | ⭐⭐☆☆ | 200 | 快速安全 |
| 4 | 快速注射链 | ⭐⭐☆☆ | 250 | LLM安全 |
| 5 | 工具链开发 | ⭐⭐☆☆ | 300 | 逻辑缺陷 |
| 6 | 采样操作 | ⭐⭐⭐☆ | 350 | 协议滥用 |
| 7 | 协议消息注入 | ⭐⭐⭐☆ | 400 | 协议安全 |
| 8 | 滥用根目录 | ⭐⭐⭐☆ | 350 | 信息披露 |
总分: 2,100
📚 你将学到什么
MCP安全基础
- 工具参数验证和净化
- 资源URI访问控制
- 系统和用户数据之间的上下文分离
- 快速注射预防技术
- 工具链安全影响
- 协议消息验证
- 能力执行
- 信息披露预防
现实世界技能
- 漏洞发现
- 开采技术
- 安全实施
- 安全文档
- 渗透测试
- 防御策略
🏆 评分和成就
评分系统
- 基点:每个挑战都有一个基点值
- 处罚:-每次失败得5分
- 提示成本:-10到-100分,具体取决于提示级别
- 最低分数:保证25%的基点
徽章
- 🩸 第一滴血 -完成你的第一个挑战
- 🦸 无提示英雄 -无提示完成3+个挑战
- ⚡ 速度恶魔 -在≤5次尝试中完成挑战
- 🎯 半路上 -完成4项挑战
- 👑 冠军 -完成全部8个挑战
- 💯 满分 -在所有已完成的挑战中获得最高积分
📖 文档
🛠️ 发展
本地开发(无Docker)
# Setup Python environment
cd mcp-server
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
# Setup data
chmod +x setup_data.sh
./setup_data.sh
# Run server
python -m src.server
项目结构
vulnmcp/
├── mcp-server/ # Main MCP server
│ ├── src/
│ │ ├── server.py # Server orchestration
│ │ └── challenges/ # Challenge modules
├── web-interface/ # Web UI
├── data/ # Flags & progress
├── docs/ # Documentation
└── docker-compose.yml # Docker config
🤝 贡献
我们欢迎捐款!看 贡献.md 作为指导方针。
贡献方式
- 报告错误
- 提出新的挑战
- 改进文档
- 增强用户界面/用户体验
- 添加测试
- 翻译内容
📊 统计
- 8 具有挑战性的水平
- 2,100 可用总积分
- 6 成就徽章
- 100% MCP重点漏洞
- 0% 通用Web挑战
🙏 致谢
📜 许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
⭐ 明星我们!
如果你觉得VulnMCP有用,请在这个存储库上加星!
由...制作❤️ MCP安全教育
