Google Threat Intelligence (GTI) MCP Server

Ein produktionsreifer Model Context Protocol (MCP)-Server, der eine umfassende Integration mit Google Threat Intelligence (GTI) und VirusTotal API v3 bietet. Entwickelt mit hochleistungsfähigem asynchronem Python, FastAPI und dem MCP-Streamable-HTTP-Transportstandard (/mcp), konzipiert für die Bereitstellung auf Google Cloud Run und die nahtlose Interaktion mit Gemini Enterprise und KI-Sicherheitsagenten.

🌟 Hauptfunktionen

• Streamable-HTTP-Transport (/mcp): Native Unterstützung für die MCP-Streamable-HTTP-Protokollspezifikation mit weiterleitungsfreiem Routing.

• 22+ Threat-Intelligence-Tools: Direkter Zugriff auf Google-Threat-Intelligence-Sammlungen, Bedrohungsakteure, Kampagnen, Malware-Familien, Berichte, Datei-Sandbox-Analysen, IP-/Domain-/URL-Telemetrie und IoC-Abfragen.

• Enterprise-Sicherheit: Native Integration mit Google Cloud Secret Manager (VT_APIKEY / VT_SECRET_NAME) stellt sicher, dass keine Geheimnisse oder API-Schlüssel im Quellcode gespeichert werden.

• Gemini Enterprise & Agent Ready: IAM-geschützte Endpunkte (roles/run.invoker) mit Google-Cloud-Identitätsauthentifizierung.

• Automatisierte Cloud-Bereitstellung: Ein Build- und Bereitstellungsskript mit einem einzigen Befehl (deploy.sh) für Google Cloud Build und Cloud Run.

Related MCP server: OSINT MCP Server

🛠️ MCP-Tool-Suite

🚀 Schnellstart

1. Voraussetzungen

• Python 3.10+

• Google Cloud SDK (gcloud) mit Projektzugriff konfiguriert

• Gültiger Google Threat Intelligence / VirusTotal API-Schlüssel

2. Lokale Einrichtung

Klonen Sie das Repository und installieren Sie die Abhängigkeiten:

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. Umgebungskonfiguration

Kopieren Sie die Beispiel-Umgebungsdatei:

cp .env.example .env

Bearbeiten Sie .env, um Ihre Einstellungen zu konfigurieren:

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. Lokal ausführen

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

☁️ Bereitstellung auf Google Cloud Run

1. API-Schlüssel in Google Secret Manager speichern

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

2. Per Skript bereitstellen

Führen Sie das automatisierte Bereitstellungsskript aus:

chmod +x deploy.sh
./deploy.sh

Vollständige Bereitstellungsdetails und IAM-Konfiguration finden Sie in DEPLOYMENT.md.

🧪 Testen und Verifizieren

Führen Sie den automatisierten Testclient gegen Ihre laufende Instanz oder den bereitgestellten Cloud-Run-Dienst aus:

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

Oder fragen Sie den MCP-Endpunkt direkt mit curl ab:

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"
      }
    }
  }'

📄 Lizenz

Dieses Projekt ist unter der Apache-2.0-Lizenz lizenziert – siehe die Datei LICENSE für Details.