Provides tools for searching GitHub repositories, listing repository files, and retrieving file content to analyze repositories for CVE research and proof-of-concept discovery
Risky Business AI MCP Server
A comprehensive Model Context Protocol (MCP) server for cybersecurity vulnerability assessment, providing tools to search GitHub repositories, query NIST NVD, access CISA's Known Exploited Vulnerabilities catalog, and analyze repository contents for CVE research and proof-of-concept discovery.
📹 Demo
Demo Workflow
The demo demonstrates a complete vulnerability assessment for CVE-2025-53770:
- ✅ Validate CVE-2025-53770 and retrieve severity information from NIST
- ✅ Analyze business impact by checking company asset inventory
- ✅ Check for active exploitation in CISA KEV database
- ✅ Search for proof-of-concept exploits on GitHub
- ✅ Generate executive dashboard with findings
- ✅ Create and deliver voice briefing
- ✅ Send summary to Beeper chat
Sample Alert Message (Sent via Beeper)
🛠️ Tools
search_github_repositories
Search GitHub repositories using the GitHub API.
Parameters:
query
(string, required): Search query with keywords and qualifierssort
(string, optional): Sort by "stars", "forks", "help-wanted-issues", "updated", or "best-match" (default)order
(string, optional): "desc" (default) or "asc"per_page
(integer, optional): Results per page, 1-100 (default: 5)page
(integer, optional): Page number (default: 1)
get_cve_from_nist
Query NIST National Vulnerability Database for CVE details.
Parameters:
cve_id
(string, required): CVE identifier (e.g., "CVE-2023-1234" or "2023-1234")
Returns: CVSS scores, severity ratings, CWE mappings, affected products (CPE), and references.
search_kev
Search CISA's Known Exploited Vulnerabilities catalog.
Parameters:
query
(string, required): Search term (CVE ID, vendor, product, or keyword)field
(string, optional): Field to search - "all", "cve_id", "vendor", "product", "vulnerability_name", "date_added" (default: "all")max_results
(integer, optional): Maximum results 1-50 (default: 10)
Returns: Matching KEV entries with exploitation details and ransomware campaign indicators.
list_github_repository_files
List all files in a GitHub repository.
Parameters:
repo_url
(string, required): GitHub repository URL (e.g., "https://github.com/owner/repo")branch
(string, optional): Branch name (default: "main")
Returns: Complete file tree with paths, types, and SHA hashes.
get_github_file_content
Retrieve specific file content from a GitHub repository.
Parameters:
repo_url
(string, required): GitHub repository URLfile_path
(string, required): Path to file (e.g., "src/exploit.py")branch
(string, optional): Branch name (default: "main")
Returns: File content (text or binary indicator) with metadata.
📝 Prompts
cve_repository_search
Generate targeted search strategies for specific CVE numbers.
Parameters:
cve_number
(string, required): CVE identifier (e.g., "CVE-2023-1234")include_poc
(boolean, optional): Include PoC-specific terms (default: true)
advanced_cve_search_strategies
Comprehensive guide for advanced CVE repository searching techniques.
📊 Resources
kev://cisa/catalog
Access the complete CISA Known Exploited Vulnerabilities catalog with active exploitation data.
assets://company/inventory
Company asset inventory for vulnerability impact assessment, including environment, criticality, and vendor information.
🚀 Quick Start
Prerequisites
- Python 3.8+
uv
(recommended) orpip
- Optional: GitHub Personal Access Token for higher API rate limits
- Optional: NIST API Key for increased rate limits
Installation
- Clone the repository
- Set up Python virtual environment
- Optional: Set up API authentication
Running the Server
With virtual environment activated:
Development mode (with MCP Inspector):
Claude Desktop Integration
Add the server to your Claude Desktop configuration:
macOS/Linux:
Windows:
Configuration:
Environment Variables
Variable | Description | Required |
---|---|---|
GITHUB_TOKEN | GitHub Personal Access Token for authentication | No (but recommended) |
NIST_API_KEY | NIST NVD API key for increased rate limits | No (optional) |
🤝 Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
Disclaimer: This tool is for legitimate security research and educational purposes. Users are responsible for ensuring their use complies with applicable laws and GitHub's terms of service.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables comprehensive cybersecurity vulnerability assessment by searching GitHub repositories for exploits, querying NIST NVD for CVE details, and accessing CISA's Known Exploited Vulnerabilities catalog. Supports complete vulnerability research workflows from threat intelligence gathering to proof-of-concept discovery.
Related MCP Servers
- AsecurityAlicenseAqualityA security testing tool that enables automated vulnerability detection including XSS and SQL injection, along with comprehensive browser interaction capabilities for web application penetration testing.Last updated -121,34617JavaScriptMIT License
- AsecurityAlicenseAqualityProvides GitHub data analysis for repositories, developers, and organizations, enabling insights into open source ecosystems through API calls and natural language queries.Last updated -513JavaScriptMIT License
- -securityAlicense-qualityA comprehensive system that helps organizations track, manage, and respond to security vulnerabilities effectively through features like vulnerability tracking, user management, support tickets, API key management, and SSL certificate management.Last updated -PythonMIT License
- -securityAlicense-qualityA server that retrieves CVE details from the NVD API and fetches EPSS scores to provide comprehensive vulnerability information, including descriptions, CWEs, CVSS scores, and exploitation likelihood percentiles.Last updated -11PythonMIT License