Skip to main content
Glama

Cyber Sentinel MCP Server

by jx888-max
GitHub
Python
MIT License
1
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

🛡️ Cyber Sentinel MCP Server

A comprehensive threat intelligence aggregation MCP (Model Context Protocol) server that provides unified access to multiple threat intelligence sources for security analysis.

🎯 Overview

Cyber Sentinel eliminates the tedious manual process of querying multiple threat intelligence sources by providing a single, unified interface. Security analysts can now analyze indicators (IPs, domains, hashes, URLs) across multiple sources with a single command, getting aggregated results with confidence scoring.

✨ Features

🔍 Threat Intelligence

  • Multi-Source Intelligence: Aggregates data from VirusTotal v3, AbuseIPDB, URLhaus, Shodan, ThreatFox, and MalwareBazaar
  • Smart Indicator Detection: Automatically detects IP addresses, domains, file hashes, and URLs
  • Intelligent Aggregation: Combines results from multiple sources with confidence scoring
  • Async Performance: High-performance concurrent processing
  • Smart Caching: Reduces API calls and improves response times (1-hour TTL)
  • Rate Limiting: Respects API limits across all sources (60 req/min default)
  • Error Recovery: Graceful handling of API failures and timeouts

🛡️ Code Security Analysis

  • Multi-Language Support: Analyzes Python, JavaScript, Java, C#, PHP, Go, Rust, C++, and SQL code
  • Vulnerability Detection: Identifies hardcoded secrets, SQL injection, XSS, path traversal, and more
  • Network Indicator Analysis: Extracts and analyzes IPs, domains, and URLs found in code
  • Secure Alternatives: Provides secure coding recommendations and alternatives
  • Risk Scoring: Calculates comprehensive security risk scores

📦 Dependency Security

  • Multi-Platform Support: Scans NPM, Python, Maven, Cargo, Go, and Composer dependencies
  • Vulnerability Detection: Identifies known malicious packages and outdated dependencies
  • Security Recommendations: Provides actionable security improvement suggestions
  • Risk Assessment: Comprehensive dependency risk scoring

🐳 Infrastructure Security

  • Docker Security: Analyzes Dockerfile configurations for security best practices
  • Kubernetes Security: Scans K8s manifests for security misconfigurations
  • CI/CD Integration: Provides security analysis for DevOps pipelines

📊 Reporting & Visualization

  • Rich Reports: Generates comprehensive security analysis reports
  • Visual Dashboards: Creates security metrics and trend visualizations
  • Export Options: Supports multiple output formats (JSON, HTML, PDF)
  • MCP Protocol: Full compatibility with MCP-enabled AI assistants

🚀 Quick Start

Prerequisites

  • Python 3.8 or higher
  • MCP-compatible client (Claude Desktop, Cursor, etc.)

Installation

  1. Clone the repository:
git clone https://github.com/jx888-max/cyber-sentinel-mcp.git cd cyber-sentinel-mcp
  1. Install dependencies:
pip install -e .
  1. 配置API密钥:
# 运行设置向导 python -m cyber_sentinel.setup_wizard # 或者直接设置环境变量 export VIRUSTOTAL_API_KEY=your_virustotal_api_key_here export ABUSEIPDB_API_KEY=your_abuseipdb_api_key_here
  1. Verify installation:
python -c "from cyber_sentinel.server import app; print('✅ Installation successful!')"

API Key Setup

  • Free Tier: 1,000 requests/day
  • Capabilities: IP, domain, hash, and URL analysis
  1. Visit VirusTotal
  2. Create a free account
  3. Get your API key from the API section
  4. Add to .env: VIRUSTOTAL_API_KEY=your_key_here
  • Free Tier: 1,000 requests/day
  • Capabilities: IP address reputation and abuse reporting
  1. Visit AbuseIPDB
  2. Create a free account
  3. Get your API key from the account settings
  4. Add to .env: ABUSEIPDB_API_KEY=your_key_here
Shodan (Optional)
  • Free Tier: 100 results/month
  • Capabilities: Internet-connected device intelligence
  1. Visit Shodan
  2. Create an account and get your API key
  3. Add to .env: SHODAN_API_KEY=your_key_here
URLhaus (No API Key Required)
  • Free: Works without API key for basic usage
  • Capabilities: Malware URL and payload tracking

🔧 MCP Client Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{ "mcpServers": { "cyber-sentinel": { "command": "python", "args": ["-m", "cyber_sentinel.server"], "cwd": "/path/to/cyber-sentinel", "env": { "VIRUSTOTAL_API_KEY": "your_virustotal_key", "ABUSEIPDB_API_KEY": "your_abuseipdb_key", "SHODAN_API_KEY": "your_shodan_key" } } } }

Cursor/VS Code

Add to your MCP configuration:

{ "mcp.servers": { "cyber-sentinel": { "command": ["python", "-m", "cyber_sentinel.server"], "cwd": "/path/to/cyber-sentinel", "env": { "VIRUSTOTAL_API_KEY": "your_virustotal_key", "ABUSEIPDB_API_KEY": "your_abuseipdb_key" } } } }

📖 Usage Examples

Once configured in your MCP client, you can use natural language to analyze security indicators:

🔍 Threat Intelligence Analysis

Analyze the IP address 8.8.8.8 for any malicious activity Check if 1.1.1.1 is safe to use Is google.com safe? Check the security status of example.com Analyze this MD5 hash: d41d8cd98f00b204e9800998ecf8427e Is this URL safe: https://example.com/suspicious-path Show me the status of all threat intelligence sources

🛡️ Code Security Analysis

Analyze this Python code for security vulnerabilities: [paste your code here] Check this JavaScript function for XSS vulnerabilities: [paste your code here] Scan this SQL query for injection risks: [paste your code here]

📦 Dependency Security Scanning

Scan these project dependencies for vulnerabilities: package.json: [paste content] requirements.txt: [paste content] Check my Python project for outdated packages: [provide requirements.txt content]

🐳 Infrastructure Security

Analyze this Dockerfile for security issues: [paste Dockerfile content] Check this Kubernetes deployment for security misconfigurations: [paste K8s YAML content]

📊 Security Reporting

Generate a comprehensive security report for my project Create a security dashboard with current threat landscape Export security findings to HTML report

🛠️ Available MCP Tools

🔍 Threat Intelligence Tools

analyze_indicator

Analyzes security indicators across multiple threat intelligence sources.

Supported Indicators:

  • IP Addresses: IPv4 addresses (e.g., 8.8.8.8)
  • Domain Names: Any domain (e.g., google.com)
  • File Hashes: MD5, SHA1, SHA256 hashes
  • URLs: Complete URLs (e.g., https://example.com)

Returns:

  • Overall reputation (clean/malicious/unknown)
  • Confidence score (0-100%)
  • Results from individual threat intelligence sources
  • Geographic and ISP information (for IPs)
  • Detailed analysis data
check_api_status

Checks the configuration and status of all threat intelligence sources.

Returns:

  • API key validation status
  • Available capabilities per source
  • Rate limiting configuration
  • Overall system health

🛡️ Security Analysis Tools

analyze_code_security

Performs comprehensive security analysis of source code.

Parameters:

  • code_content: Source code to analyze
  • language: Programming language (auto-detected if not specified)
  • locale: Output language (zh/en)

Returns:

  • Security vulnerabilities and their severity
  • Hardcoded secrets and credentials
  • Network indicators found in code
  • Secure coding recommendations
  • Risk score and remediation guidance
scan_project_dependencies

Scans project dependencies for security vulnerabilities.

Parameters:

  • project_files: Dictionary of dependency files (package.json, requirements.txt, etc.)

Returns:

  • Known malicious packages
  • Outdated dependencies with vulnerabilities
  • Security recommendations
  • Risk assessment and scoring
analyze_docker_security

Analyzes Docker configurations for security best practices.

Parameters:

  • dockerfile_content: Dockerfile content to analyze

Returns:

  • Security misconfigurations
  • Best practice violations
  • Hardening recommendations
  • Risk assessment
scan_kubernetes_config

Scans Kubernetes manifests for security issues.

Parameters:

  • k8s_manifests: Dictionary of Kubernetes YAML files

Returns:

  • Security policy violations
  • Privilege escalation risks
  • Network security issues
  • Compliance recommendations
generate_security_report

Generates comprehensive security reports with visualizations.

Parameters:

  • analysis_results: Combined results from security analyses
  • report_format: Output format (json/html/markdown)

Returns:

  • Formatted security report
  • Executive summary
  • Detailed findings
  • Remediation roadmap

📊 Example Response

{ "indicator": "8.8.8.8", "type": "ip", "overall_reputation": "clean", "confidence": 100.0, "sources_checked": 4, "sources_responded": 3, "malicious_sources": 0, "clean_sources": 3, "countries": ["US"], "isps": ["Google LLC"], "detailed_results": [ { "source": "VirusTotal", "reputation": "clean", "malicious_count": 0, "total_engines": 89 } ], "errors": [], "timestamp": "2024-01-15T10:30:00Z" }

⚡ Performance & Reliability

🚀 High Performance

  • Async Architecture: High-performance concurrent processing across all analysis tools
  • Smart Caching: 1-hour TTL reduces API calls and improves response times
  • Parallel Processing: Simultaneous analysis across multiple threat intelligence sources
  • Optimized Algorithms: Efficient pattern matching and vulnerability detection

🛡️ Reliability & Resilience

  • Rate Limiting: Configurable limits (default: 60 requests/minute) with intelligent throttling
  • Timeout Handling: 30-second request timeouts prevent hanging operations
  • Error Recovery: Graceful handling of API failures and network issues
  • Fallback Mechanisms: Continues analysis even when some sources are unavailable
  • Retry Logic: Automatic retry with exponential backoff for transient failures

🔒 Security & Privacy

🛡️ Data Protection

  • Zero Data Storage: No indicators, code, or analysis results are permanently stored
  • Memory-Only Processing: All analysis happens in memory with automatic cleanup
  • API Key Security: Keys managed securely through environment variables and encrypted storage
  • Source Isolation: Each threat intelligence source operates independently with isolated credentials

🔐 Privacy Safeguards

  • Local Processing: Code analysis happens locally without external transmission
  • Error Isolation: Sensitive information is never exposed in error messages or logs
  • Audit Trail: Optional security event logging for compliance requirements
  • Data Minimization: Only necessary data is processed and immediately discarded

🧪 Testing

Run the test suite to verify functionality:

# Run unit tests python -m pytest tests/ -v # Test with your API keys python -c " from cyber_sentinel.server import check_api_status import asyncio print(asyncio.run(check_api_status())) "

📄 License

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

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Make your changes and add tests
  4. Commit your changes (git commit -m 'Add amazing feature')
  5. Push to the branch (git push origin feature/amazing-feature)
  6. Open a Pull Request

🆘 Support

🙏 Acknowledgments

  • Anthropic for the MCP protocol and Claude AI
  • VirusTotal for comprehensive malware analysis
  • AbuseIPDB for IP reputation intelligence
  • URLhaus for malware URL tracking
  • Shodan for internet device intelligence
  • ThreatFox for IOC sharing platform
  • MalwareBazaar for malware sample intelligence
  • OWASP for security best practices and vulnerability patterns
  • Open source security community for continuous threat intelligence sharing

🛡️ Threat Intelligence, Simplified.

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

A threat intelligence aggregation server that provides unified access to multiple security sources for analyzing indicators (IPs, domains, hashes, URLs) with confidence scoring.

  1. 🎯 Overview
    1. ✨ Features
      1. 🔍 Threat Intelligence
      2. 🛡️ Code Security Analysis
      3. 📦 Dependency Security
      4. 🐳 Infrastructure Security
      5. 📊 Reporting & Visualization
    2. 🚀 Quick Start
      1. Prerequisites
      2. Installation
      3. API Key Setup
    3. 🔧 MCP Client Configuration
      1. Claude Desktop
      2. Cursor/VS Code
    4. 📖 Usage Examples
      1. 🔍 Threat Intelligence Analysis
      2. 🛡️ Code Security Analysis
      3. 📦 Dependency Security Scanning
      4. 🐳 Infrastructure Security
      5. 📊 Security Reporting
    5. 🛠️ Available MCP Tools
      1. 🔍 Threat Intelligence Tools
      2. 🛡️ Security Analysis Tools
    6. 📊 Example Response
      1. ⚡ Performance & Reliability
        1. 🚀 High Performance
        2. 🛡️ Reliability & Resilience
      2. 🔒 Security & Privacy
        1. 🛡️ Data Protection
        2. 🔐 Privacy Safeguards
      3. 🧪 Testing
        1. 📄 License
          1. 🤝 Contributing
            1. 🆘 Support
              1. 🙏 Acknowledgments

                Related MCP Servers

                • VirusTotal MCP Server

                  emeryray2002
                  -
                  security
                  A
                  license
                  -
                  quality
                  Provides comprehensive security analysis tools for querying the VirusTotal API, enabling detailed security reports on URLs, files, IP addresses, and domains with automatic relationship data fetching.
                  Last updated -
                  3
                  Python
                  Apache 2.0

                • MCP Vulnerability Management System

                  nesirat
                  -
                  security
                  A
                  license
                  -
                  quality
                  A 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 -
                  Python
                  MIT License

                • Mallory MCP Serverofficial

                  malloryai
                  -
                  security
                  F
                  license
                  -
                  quality
                  A robust Model Control Protocol server that enables AI agents to access real-time cyber threat intelligence and detailed information about vulnerabilities, threat actors, malware, and other cyber-security entities.
                  Last updated -
                  5
                  Python

                • Enrichment MCP Server

                  synackpwn
                  -
                  security
                  F
                  license
                  -
                  quality
                  A Model Context Protocol server that performs third-party threat intelligence enrichment for various observables (IP addresses, domains, URLs, emails) using services like VirusTotal, Shodan, and AbuseIPDB.
                  Last updated -

                View all related MCP servers

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/jx888-max/cyber-sentinel-mcp'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server