Quake MCP

Quake MCP サーバー

中文说明：README_CN.md.

概要

Quake MCP Server は、360 Quake Network Space Mapping Platform を基盤とする Model Context Protocol（MCP）プラグインです。主に次の 2 つの機能を提供します。

• アセットデータのクエリ：ネットワークアセットの詳細情報を取得します。
• アセットの集計：ネットワークアセットデータを分析し、集計します。

DSL クエリ構文の柔軟性を活用することで、Quake MCP Server はネットワークアセットの収集、分布分析、セキュリティ脆弱性評価、ネットワーク空間のプロファイリングを実行できます。AI 環境でリアルタイムのアセット検索や統計分析を行うために欠かせないツールです。

---

機能

🔍 アセットデータのクエリ（quake_service_data）

• ネットワークアセットの詳細情報を取得できます。
• クエリ構文、時間範囲、ページネーションによる絞り込みに対応しています。

📊 アセットの集計（quake_service_aggregation）

• ネットワークアセットに関する集計統計データを提供します。これには、次の項目などが含まれます。
  • ポートの分布
  • プロトコル／サービス種別の分布
  • 地理的な分布

---

はじめに

1. NaMiAI でのセットアップ

1. NaMiAI の MCP Toolbox で Quake MCP を検索します。
2. Install をクリックし、API Key を入力して設定を完了します。（Quake platform にログインし、User Center → API Token に移動して API Key を取得します）
3. セットアップが完了したら、Quake MCP Server を使ってアセットのクエリと集計を実行できます。

2. サーバーの設定

{
  "mcpServers": {
    "Quake MCP Server": {
      "disabled": false,
      "timeout": 60,
      "type": "streamableHttp",
      "url": "https://quake.360.net/mcp/",
      "headers": {
        "X-QuakeToken": "your QuakeToken"
      }
    }
  }
}

---

API の使用方法

1. アセットデータのクエリ（quake_service_data）

説明
指定したクエリ構文に基づいて、ネットワークアセットの詳細情報を取得します。

パラメーター：

• query（string、必須）：DSL クエリ文字列（例：domain:"example.com"）。
• start_time（string、任意）：クエリの開始時刻（UTC 形式）。
• end_time（string、任意）：クエリの終了時刻（UTC 形式）。
• start（int、任意）：ページネーションの開始位置。デフォルトは 0 です。
• size（int、任意）：1 ページあたりの結果数。デフォルトは 100 です。

レスポンス：

• code：レスポンスコード（0 は成功を示します）。
• message：レスポンスメッセージ（例："Successful."）。
• total_count：見つかったアセットの総数。
• data：アセット詳細のリスト（IP、ポート、サービス、地理的位置など）。
• meta：ページネーションの詳細。

2. アセットの集計（quake_service_aggregation）

説明
クエリに基づいて、ネットワークアセットの集計統計データを返します。

パラメーター：

• query（string、必須）：DSL クエリ文字列（例：country:CN）。
• start_time（string、任意）：クエリの開始時刻（UTC 形式）。
• end_time（string、任意）：クエリの終了時刻（UTC 形式）。

レスポンス：

• code：レスポンスコード（0 は成功を示します）。
• message：レスポンスメッセージ（例："Successful."）。
• data：集計データ（例：ポートの分布、サービス種別、地理的な分布）。

---

使用例

• ネットワークアセットの収集：指定したドメイン、IP、組織のネットワークアセット情報をすばやく取得します。
• アセット分布の分析：ポート、プロトコル／サービス種別、地理的位置ごとのアセット分布を分析します。
• セキュリティ脆弱性評価：潜在的にリスクのあるアセットや異常なサービスの特定に役立ちます。
• ネットワーク空間のプロファイリング：アセットデータと集計統計を組み合わせて、組織や地域のネットワーク空間を包括的に把握します。

---

FAQ

Q1：DSL クエリ構文とは何ですか？

DSL（Domain Specific Language）クエリ構文は、Quake でアセットを検索するために使用します。クエリの例を以下に示します。

• domain:"example.com"：ドメイン example.com 配下のアセットを検索します。
• port:22 AND country:CN：中国でポート 22 が公開されているアセットを検索します。

Q2: API トークンを取得する方法を教えてください。

Quake プラットフォームにログインし、ユーザーセンター → API Token に移動して、新しいトークンを生成してください。

Q3: クエリ結果のポイント差し引きの仕組みを教えてください。

ポイント差し引きの仕組みは、API 呼び出しの差し引きシステムに準拠しています。クエリの頻度とデータ取得量に応じてポイントが差し引かれます。

---

特記事項

Quake MCP Server は、ネットワーク資産のセキュリティを強化するために設計されています。本サービスを利用することで、コンピューターネットワークのセキュリティを損なうおそれのある活動を行わないことに同意するものとします。これらの活動には、以下のものが含まれますが、これらに限定されません。

1. 不正侵入：他者のネットワークへの不正アクセス、ネットワークの正常な機能の妨害、またはネットワークデータの窃取。
2. 無許可のデータアクセス：許可されていないデータの使用、または承認されていないサーバー／アカウントへのアクセス。
3. 不法なネットワークアクセス：公共のコンピューターネットワークやその他のコンピューターシステムへの不正アクセス、および保存されている情報の削除、変更、追加。
4. 脆弱性スキャンまたはテスト：他者のシステムやネットワークの弱点を調査、スキャン、テストしようとすること、またはネットワークセキュリティを損なうおそれのあるその他の行為。
5. その他の違法行為または不法行為：法令で禁止されているその他の活動。

---

まとめ

Quake MCP Server は、ネットワーク資産データを収集、分析、集約するための効率的で柔軟な方法を提供します。AI 環境との統合と強力なクエリ機能の活用により、セキュリティ専門家は脆弱性評価、資産プロファイリング、脅威インテリジェンスに必要なデータを迅速に収集できます。