CyberMCP - Cybersecurity API Testing with MCP

🔒 CyberMCP

借助 Model Context Protocol (MCP) 进行 AI 驱动的网络安全 API 测试

CyberMCP 是一个 Model Context Protocol (MCP) 服务，可让 AI Agent 对后端 API 执行全面的安全测试。它提供 14 种专用安全工具和 10 项资源，用于识别身份验证绕过、注入攻击、数据泄露和安全配置错误等漏洞。

🚀 快速开始

# Clone and setup
git clone https://github.com/your-username/CyberMCP.git
cd CyberMCP
npm install
npm run build

# Test the server
npm run test-server

# Start interactive testing
npm run test-interactive

✨ 功能

• 🔐 身份验证测试 - JWT 分析、绕过检测、OAuth2 流程
• 💉 注入测试 - SQL 注入、XSS 漏洞检测
• 📊 数据保护 - 敏感数据泄露、路径遍历检查
• ⏱️ 速率限制 - DoS 漏洞评估
• 🛡️ 安全标头 - OWASP 安全标头验证
• 📚 全面的资源 - 安全检查清单和测试指南

🛠️ 安全工具（共 14 种）

类别	工具
身份验证	basic_auth、token_auth、oauth2_auth、api_login、auth_status、clear_auth、jwt_vulnerability_check、auth_bypass_check
注入测试	sql_injection_check、xss_check
数据保护	sensitive_data_check、path_traversal_check
基础设施	rate_limit_check、security_headers_check

🎯 IDE 集成

CyberMCP 适用于所有主流 AI 驱动的 IDE：

• Claude Desktop - 直接集成 MCP
• Cursor IDE - 内置 MCP 支持
• Windsurf (Codeium) - 原生 MCP 协议
• VS Code + Cline - 基于扩展的集成

📖 完整设置指南 - 各 IDE 的详细配置

📋 使用示例

"Use basic_auth with username 'admin' and password 'secret123' 
then use auth_bypass_check on https://api.example.com/users 
to test for authentication bypass vulnerabilities"

AI Agent 将：

1. 配置身份验证凭据
2. 测试受保护的端点，检查是否存在绕过漏洞
3. 提供详细的安全分析和建议

📊 测试与验证

# Comprehensive tool testing
npm run test-tools

# Manual interactive testing  
npm run test-interactive

# Quick setup verification
npm run quick-start

# MCP Inspector (GUI)
npm run inspector

📁 项目结构

CyberMCP/
├── src/                    # TypeScript source code
│   ├── tools/             # 14 security testing tools
│   ├── resources/         # Security checklists & guides
│   └── utils/             # Authentication & utilities
├── docs/                  # Documentation
├── scripts/               # Testing & utility scripts  
├── examples/              # Configuration examples
├── dist/                  # Built JavaScript (generated)
└── README.md              # This file

🔧 开发

# Development mode with hot reload
npm run dev

# Build TypeScript
npm run build

# Start server (stdio mode)
npm start

# Start HTTP server
TRANSPORT=http PORT=3000 npm start

📖 文档

• 设置指南 - 详细的安装和配置说明
• 项目摘要 - 完整的功能概览
• 测试结果 - 验证和测试覆盖率

🤝 贡献

1. Fork 此仓库
2. 创建功能分支：git checkout -b feature/new-security-tool
3. 进行更改并添加测试
4. 提交拉取请求

📄 许可证

本项目采用 MIT License 许可 - 详情请参阅 LICENSE 文件。

🔗 资源

• Model Context Protocol - MCP 官方文档
• OWASP API Security - API 安全最佳实践
• MCP TypeScript SDK - 开发框架

---

🔒 借助 AI 驱动的测试保护您的 API！

如需支持或有疑问，请创建 issue。