<div align="center">

🛡️ CyberMCP

AI-Powered Cyber Security Assistant built with Model Context Protocol (MCP)

A production-ready MCP Server that brings cybersecurity analysis tools directly to AI assistants such as Claude Desktop.

</div>

---

✨ Overview

CyberMCP is an AI-powered Cyber Security Assistant built on the Model Context Protocol (MCP).

Instead of manually checking DNS, SSL certificates, HTTP headers, cookies, or security configurations, AI assistants can invoke CyberMCP tools and receive structured security analysis automatically.

CyberMCP follows a Clean Architecture approach with modular services, asynchronous networking, and defensive security principles.

---

🚀 Features

Feature	Description
🌍 RDAP Lookup	Retrieve domain registration information
🌐 DNS Analyzer	Analyze A, AAAA, MX, TXT, NS records
🔒 SSL Inspector	Inspect SSL/TLS certificates
🛡 Security Headers	Detect missing HTTP security headers
🍪 Cookie Analyzer	Analyze Secure, HttpOnly & SameSite
🧬 Technology Fingerprinting	Detect web technologies
🤖 robots.txt Analyzer	Parse robots.txt
📄 security.txt Checker	Find security contact information
📊 Website Audit	Run all security checks together
📑 Report Generator	Export HTML & JSON reports

---

🏗️ Architecture

                 AI Assistant
             (Claude Desktop)
                     │
                     ▼
              Model Context Protocol
                     │
                     ▼
                CyberMCP Server
                     │
 ┌──────────────┬───────────────┬───────────────┐
 │              │               │               │
 ▼              ▼               ▼               ▼
 RDAP        DNS Analyzer    SSL Checker    Headers
 │
 ▼
 Services
 │
 ▼
 External APIs / DNS / Websites

---

📂 Project Structure

CyberMCP/

├── mcp_server.py
├── README.md
├── requirements.txt
│
├── tools/
├── services/
├── models/
├── utils/
├── tests/
└── docs/

---

⚙️ Installation

Clone the repository

git clone https://github.com/YOUR_USERNAME/CyberMCP.git

cd CyberMCP

Create virtual environment

python -m venv .venv

Activate environment

Windows

.venv\Scripts\activate

Linux / macOS

source .venv/bin/activate

Install dependencies

pip install -r requirements.txt

---

▶️ Run Development Server

mcp dev mcp_server.py

---

🔗 Claude Desktop Integration

Edit:

claude_desktop_config.json

Example:

{
  "mcpServers": {
    "CyberMCP": {
      "command": "python",
      "args": [
        "/path/to/CyberMCP/mcp_server.py"
      ]
    }
  }
}

---

💡 Example

Ask Claude:

Analyze the security of openai.com

Claude automatically calls:

✔ RDAP Lookup

✔ DNS Analyzer

✔ SSL Inspection

✔ Security Headers

✔ robots.txt

✔ security.txt

✔ Technology Fingerprinting

Result:

Security Score : 91/100

SSL           ✔

HSTS          ✔

CSP           ✖

robots.txt    ✔

security.txt  ✔

---

🛣️ Roadmap

• [x] FastMCP Server
• [x] RDAP Lookup
• [x] DNS Analyzer
• [x] SSL Inspector
• [x] Header Analyzer
• [ ] Cookie Analyzer
• [ ] Website Audit
• [ ] HTML Report
• [ ] PDF Report
• [ ] VirusTotal Integration
• [ ] AbuseIPDB Integration

---

🤝 Contributing

Contributions are welcome!

Feel free to open an Issue or submit a Pull Request.

---

<div align="center">

Made with ❤️ using Python, FastMCP, and Model Context Protocol

⭐ If you find this project useful, don't forget to give it a star!

</div>