Thanks to visit codestin.com
Credit goes to github.com

Skip to content

CyberMCP is a Model Context Protocol (MCP) server designed for testing backend APIs for security vulnerabilities. It provides a set of specialized tools and resources that can be used by LLMs to identify common security issues in APIs.

License

Notifications You must be signed in to change notification settings

ricauts/CyberMCP

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🔒 CyberMCP

AI-powered Cybersecurity API Testing with Model Context Protocol (MCP)

License: MIT Node.js TypeScript

CyberMCP is a Model Context Protocol (MCP) server that enables AI agents to perform comprehensive security testing on backend APIs. It provides 14 specialized security tools and 10 resources for identifying vulnerabilities like authentication bypass, injection attacks, data leakage, and security misconfigurations.

🚀 Quick Start

# 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

✨ Features

  • 🔐 Authentication Testing - JWT analysis, bypass detection, OAuth2 flows
  • 💉 Injection Testing - SQL injection, XSS vulnerability detection
  • 📊 Data Protection - Sensitive data exposure, path traversal checks
  • ⏱️ Rate Limiting - DoS vulnerability assessment
  • 🛡️ Security Headers - OWASP security header validation
  • 📚 Comprehensive Resources - Security checklists and testing guides

🛠️ Security Tools (14 Total)

Category Tools
Authentication basic_auth, token_auth, oauth2_auth, api_login, auth_status, clear_auth, jwt_vulnerability_check, auth_bypass_check
Injection Testing sql_injection_check, xss_check
Data Protection sensitive_data_check, path_traversal_check
Infrastructure rate_limit_check, security_headers_check

🎯 IDE Integration

CyberMCP works with all major AI-powered IDEs:

  • Claude Desktop - Direct MCP integration
  • Cursor IDE - Built-in MCP support
  • Windsurf (Codeium) - Native MCP protocol
  • VS Code + Cline - Extension-based integration

📖 Complete Setup Guide - Detailed configuration for each IDE

📋 Usage Example

"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"

The AI agent will:

  1. Configure authentication credentials
  2. Test the protected endpoint for bypass vulnerabilities
  3. Provide detailed security analysis and recommendations

📊 Testing & Validation

# 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

📁 Project Structure

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

# 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

📖 Documentation

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/new-security-tool
  3. Make your changes and add tests
  4. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Resources


🔒 Secure your APIs with AI-powered testing!

For support and questions, please create an issue.

About

CyberMCP is a Model Context Protocol (MCP) server designed for testing backend APIs for security vulnerabilities. It provides a set of specialized tools and resources that can be used by LLMs to identify common security issues in APIs.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published