🛡️ CyberShield MCP — Servidor MCP de Defensa Autónoma (Windows)

CyberShield MCP es un servidor MCP (Model Context Protocol) completamente funcional diseñado para ejecutar herramientas defensivas, consultar recursos del sistema y tomar decisiones de seguridad con apoyo de inteligencia artificial.

Funciona sobre Windows, expone comandos críticos del sistema de forma segura, y puede ser controlado desde Claude Desktop o mediante agentes LangChain, creando así una defensa contextual, precisa y autónoma.

---

⚙️ Requisitos y dependencias

💡 Solo compatible con Windows por ahora (utiliza netsh, ping, Get-WinEvent, etc.)

Instalación rápida:

pip install mcp[cli] langchain langchain-ollama fastapi uvicorn requests

Si usás variables de entorno en .env, ejecutá:

mcp install -f

---

📂 Estructura del proyecto

cybershield_mcp/
├── server.py               # Punto de entrada principal
├── pyproject.toml          # Configuración del proyecto (con uv o poetry)
├── README.md               # Descripción del proyecto
├── .env                    # Variables de entorno (si usás mcp install -f)
│
├── tools/                  # Herramientas de defensa y diagnóstico
│   ├── __init__.py
│   ├── firewall.py         # Bloqueo y desbloqueo de puertos/IPs
│   ├── diagnostics.py      # Ping y escaneo con nmap
│   ├── logs.py             # Análisis de logs con Context
│   ├── hardening.py        # Fortalecimiento del sistema
│   ├── agent_response.py   # Acciones automáticas y diagnóstico rápido
│   ├── network_watch.py    # Conexiones activas y detección de IPs raras
│   ├── eventlog_analyzer.py # Revisión de eventos de seguridad (logins fallidos, privilegios)
│   └── processes.py        # Escaneo y gestión de procesos activos
│
├── resources/
│   ├── __init__.py
│   └── firewall_state.py   # Consulta del estado actual del firewall
│
├── prompts/
│   ├── __init__.py
│   └── threat_response.py  # Prompt para decidir acción ante amenazas
│
├── utils/
│   ├── __init__.py
│   └── commands.py         # Funciones comunes para subprocess seguro
│
├── fastapi_mcp_server.py   # Exposición HTTP de herramientas MCP para integración externa
├── agent_langchain.py      # Agente IA con LangChain + Ollama usando MCP vía FastAPI
├── Dockerfile              # Imagen Docker del servidor FastAPI
├── docker-compose.yml      # Despliegue simplificado con Docker Compose

---

🧠 Modos de uso con IA

🧠 Claude Desktop

1. Instalar tu servidor en Claude:

uv run mcp install server.py --name "CyberShield Agent"

2. Ejecutar el servidor MCP:

uv run mcp dev server.py

3. Claude ahora podrá usar frases como:
- "Haz ping a 8.8.8.8"
- "Bloquea la IP 192.168.1.50"
- "Activa el modo cuarentena"
- "¿Estoy bajo ataque?"

---

🔗 LangChain + Ollama (modo agente autónomo)

1. Levantar el servidor FastAPI:

uvicorn fastapi_mcp_server:app --port 4242

2. Usar agent_langchain.py para lanzar un agente con herramientas como:
- bloquear ip automáticamente
- diagnóstico del sistema
- listar procesos sospechosos

python agent_langchain.py

3. El agente decidirá con tu LLM cuándo ejecutar herramientas defensivas (bloqueo, diagnóstico, etc.)

---

🐳 Integración con Docker

Dockerfile

Ya incluido en el proyecto. Crea una imagen del servidor FastAPI para correr en cualquier entorno.

Para construir y correr:

docker build -t cybershield-api .
docker run -p 4242:4242 --name cybershield cybershield-api

O con docker-compose:

docker-compose up --build

Esto te da:
- Reproducibilidad
- Despliegue rápido
- Entorno controlado
- Posibilidad de llevar tu MCP a servidores Linux sin instalación directa

---

🧪 Testing con MCP Inspector

Corré:

uv run mcp dev server.py

Podés ver:
- Funciones ejecutadas
- Argumentos pasados
- Tiempos de respuesta y errores

---

💬 Ejemplos rápidos (Claude o LangChain)

🛠 @tool: do_ping(host: str)
> "Haz ping a 8.8.8.8"

📦 @resource: firewall://rules
> "Muéstrame las reglas activas del firewall"

🧠 @prompt: suggest_block_action(threat_description)
> "He detectado conexiones sospechosas desde 192.168.1.42. ¿Qué debería hacer?"

🔗 FastAPI
> GET http://localhost:4242/tools/system_diagnostic

---

🧰 ¿Qué podés hacer con CyberShield MCP?

✅ Automatizar defensa en sistemas Windows
✅ Ejecutar comandos críticos mediante IA
✅ Fortalecer el sistema y reducir superficie de ataque
✅ Coordinar respuestas desde agentes IA o modelos conversacionales
✅ Exponer herramientas como endpoints HTTP para integraciones más amplias
✅ Desplegarlo fácilmente en cualquier entorno con Docker

¿Listo para una defensa con cerebro? Clonalo, conectalo con Claude o tu agente LangChain, ¡y empezá a blindar tu sistema! 💥