Google Threat Intelligence (GTI) MCP サーバー

本番環境対応の Model Context Protocol (MCP) サーバーであり、Google Threat Intelligence (GTI) および VirusTotal API v3 との包括的な統合を提供します。高性能な非同期 Python、FastAPI、および MCP Streamable HTTP トランスポート標準 (/mcp) を採用し、Google Cloud Run へのデプロイ、Gemini Enterprise および AI Security Agent とのシームレスな連携を想定して設計されています。

🌟 主な機能

• ストリーミング可能 HTTP トランスポート (/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. 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

または、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 ファイルを参照してください。