Google Threat Intelligence (GTI) MCP Server

Производственный сервер Model Context Protocol (MCP), обеспечивающий полную интеграцию с Google Threat Intelligence (GTI) и VirusTotal API v3. Создан на высокопроизводительном асинхронном Python, FastAPI и стандарте транспорта MCP Streamable HTTP (/mcp), предназначен для развертывания на Google Cloud Run и бесшовного взаимодействия с Gemini Enterprise и AI Security Agents.

🌟 Ключевые возможности

• Streamable HTTP Transport (/mcp): Нативная поддержка спецификации протокола MCP Streamable HTTP с маршрутизацией без перенаправлений.

• 22+ инструментов разведки угроз: Прямой доступ к коллекциям Google Threat Intelligence, Threat Actors, Campaigns, Malware Families, Reports, File Sandbox Analyses, IP/Domain/URL телеметрии и поиску IoC.

• Корпоративная безопасность: Нативная интеграция с Google Cloud Secret Manager (VT_APIKEY / VT_SECRET_NAME) гарантирует отсутствие секретов и ключей API в исходном коде.

• Готовность к Gemini Enterprise и агентам: Защищенные IAM конечные точки (roles/run.invoker) с аутентификацией через Google Cloud identity.

• Автоматизированное облачное развертывание: Скрипт сборки и развертывания одной командой (deploy.sh) с Google Cloud Build и Cloud Run.

Related MCP server: OSINT MCP Server

🛠️ Набор инструментов MCP

🚀 Быстрый старт

1. Предварительные требования

• Python 3.10+

• Google Cloud SDK (gcloud) с настроенным доступом к проекту

• Действительный ключ API Google Threat Intelligence / VirusTotal

2. Локальная настройка

Клонируйте репозиторий и установите зависимости:

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. Конфигурация окружения

Скопируйте пример файла окружения:

cp .env.example .env

Отредактируйте .env для настройки параметров:

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. Локальный запуск

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

☁️ Развертывание на Google Cloud Run

1. Сохранение ключа API в 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. Развертывание через скрипт

Выполните автоматизированный скрипт развертывания:

chmod +x deploy.sh
./deploy.sh

Полные сведения о развертывании и настройке IAM см. в DEPLOYMENT.md.

🧪 Тестирование и проверка

Запустите автоматизированный тестовый клиент для вашего запущенного экземпляра или развернутого сервиса Cloud Run:

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

Или запросите конечную точку MCP напрямую с помощью 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"
      }
    }
  }'

📄 Лицензия

Этот проект лицензирован под лицензией Apache 2.0 — подробности см. в файле LICENSE.