Servidor MCP de Google Threat Intelligence (GTI)

Un servidor Model Context Protocol (MCP) listo para producción que proporciona una integración completa con Google Threat Intelligence (GTI) y VirusTotal API v3. Construido con Python asíncrono de alto rendimiento, FastAPI y el estándar de transporte MCP Streamable HTTP (/mcp), diseñado para su despliegue en Google Cloud Run y una interacción fluida con Gemini Enterprise y los Agentes de Seguridad de IA.

🌟 Características principales

• Transporte HTTP Streamable (/mcp): Soporte nativo para la especificación del protocolo MCP Streamable HTTP con enrutamiento sin redirecciones.

• Más de 22 herramientas de inteligencia de amenazas: Acceso directo a colecciones de Google Threat Intelligence, Actores de Amenazas, Campañas, Familias de Malware, Informes, Análisis de Sandbox de Archivos, telemetría de IP/Dominio/URL y búsquedas de IoC.

• Seguridad empresarial: Integración nativa con Google Cloud Secret Manager (VT_APIKEY / VT_SECRET_NAME) garantiza que no se almacenen secretos ni claves API en el código fuente.

• Preparado para Gemini Enterprise y Agentes: Endpoints protegidos por IAM (roles/run.invoker) con autenticación de identidad de Google Cloud.

• Despliegue automatizado en la nube: Script de compilación y despliegue con un solo comando (deploy.sh) con Google Cloud Build y Cloud Run.

Related MCP server: OSINT MCP Server

🛠️ Conjunto de herramientas MCP

🚀 Inicio rápido

1. Requisitos previos

• Python 3.10+

• Google Cloud SDK (gcloud) configurado con acceso al proyecto

• Clave API de Google Threat Intelligence / VirusTotal válida

2. Configuración local

Clona el repositorio e instala las dependencias:

git clone https://github.com/yayefa/GTI-MCP-Server.git
cd GTI-MCP-Server

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

3. Configuración del entorno

Copia el archivo de entorno de muestra:

cp .env.example .env

Edita .env para configurar tus ajustes:

PROJECT_ID=your-gcp-project-id
REGION=us-central1
SERVICE_NAME=mcp-gti-mcp-server
VT_SECRET_NAME=VT_APIKEY
SECRET_PROJECT_ID=your-gcp-project-id
LOG_LEVEL=INFO

4. Ejecución local

uvicorn server:app --host 0.0.0.0 --port 8080 --reload

☁️ Despliegue en Google Cloud Run

1. Almacena la clave API en Google Secret Manager

echo -n "YOUR_GTI_VT_API_KEY" | gcloud secrets create "VT_APIKEY" \
    --data-file=- \
    --project="YOUR_PROJECT_ID" \
    --replication-policy="automatic"

2. Despliega mediante script

Ejecuta el script de despliegue automatizado:

chmod +x deploy.sh
./deploy.sh

Para obtener detalles completos del despliegue y la configuración de IAM, consulta DEPLOYMENT.md.

🧪 Pruebas y verificación

Ejecuta el cliente de pruebas automatizado contra tu instancia en ejecución o el servicio desplegado en Cloud Run:

AUTH_TOKEN=$(gcloud auth print-identity-token) \
TARGET_URL="https://<YOUR-CLOUD-RUN-URL>" \
python3 test_client.py

O consulta el endpoint MCP directamente usando curl:

curl -X POST https://<YOUR-CLOUD-RUN-URL>/mcp \
  -H "Authorization: Bearer $(gcloud auth print-identity-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_ip_report",
      "arguments": {
        "ip_address": "8.8.8.8"
      }
    }
  }'

📄 Licencia

Este proyecto está licenciado bajo la licencia Apache 2.0; consulta el archivo LICENSE para obtener más detalles.