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 컬렉션, 위협 행위자, 캠페인, 악성코드 계열, 보고서, 파일 샌드박스 분석, IP/도메인/URL 원격 분석 및 IoC 조회에 직접 접근.

• 엔터프라이즈 보안: Google Cloud Secret Manager (VT_APIKEY / VT_SECRET_NAME)와의 기본 통합으로 소스 코드에 비밀번호나 API 키가 저장되지 않음.

• Gemini Enterprise 및 Agent 준비 완료: Google Cloud ID 인증을 통해 IAM으로 보호된 엔드포인트 (roles/run.invoker).

• 자동화된 클라우드 배포: Google Cloud Build 및 Cloud Run을 사용하는 원클릭 빌드 및 배포 스크립트 (deploy.sh).

Related MCP server: OSINT MCP Server

🛠️ MCP 도구 모음

🚀 빠른 시작

1. 전제 조건

• Python 3.10+

• Google Cloud SDK (gcloud)가 프로젝트 액세스 권한으로 구성되어 있어야 함

• 유효한 Google Threat Intelligence / VirusTotal API 키

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. Secret Manager에 API 키 저장

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

또는 curl을 사용하여 MCP 엔드포인트에 직접 쿼리합니다:

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 파일을 참조하세요.