Quake MCP

Quake MCP 服务

中文说明：README_CN.md。

概述

Quake MCP Server 是基于 360 Quake 网络空间测绘平台 的模型上下文协议（MCP）插件，提供两项主要功能：

• 资产数据查询：获取详细的网络资产信息。
• 资产聚合：分析并聚合网络资产数据。

借助灵活的 DSL 查询语法，Quake MCP Server 可帮助用户开展网络资产收集、分布分析、安全漏洞评估和网络空间画像。它是 AI 环境中执行实时资产搜索与统计分析的必备工具。

---

功能特性

🔍 资产数据查询（quake_service_data）

• 可获取详细的网络资产信息。
• 支持按查询语法、时间范围和分页筛选。

📊 资产聚合（quake_service_aggregation）

• 提供网络资产的聚合统计数据，包括但不限于：
  • 端口分布
  • 协议／服务类型分布
  • 地理分布

---

入门指南

1. 在 NaMiAI 中设置

1. 在 NaMiAI MCP 工具箱中搜索 Quake MCP。
2. 点击 Install，然后输入 API Key 完成配置。（登录 Quake 平台，前往 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（字符串，必填）：DSL 查询字符串（例如：domain:"example.com"）。
• start_time（字符串，可选）：查询的开始时间，采用 UTC 格式。
• end_time（字符串，可选）：查询的结束时间，采用 UTC 格式。
• start（整数，可选）：分页起始位置，默认为 0。
• size（整数，可选）：每页结果数，默认为 100。

响应：

• code：响应代码（0 表示成功）。
• message：响应消息（例如："Successful."）。
• total_count：找到的资产总数。
• data：资产详细信息列表（IP、端口、服务、地理位置等）。
• meta：分页详情。

2. 资产聚合（quake_service_aggregation）

说明
根据查询条件返回网络资产的聚合统计数据。

参数：

• query（字符串，必填）：DSL 查询字符串（例如：country:CN）。
• start_time（字符串，可选）：查询的开始时间，采用 UTC 格式。
• end_time（字符串，可选）：查询的结束时间，采用 UTC 格式。

响应：

• code：响应代码（0 表示成功）。
• message：响应消息（例如："Successful."）。
• data：聚合数据（例如：端口分布、服务类型、地理分布）。

---

使用场景

• 网络资产收集：快速获取指定域名、IP 或组织的网络资产信息。
• 资产分布分析：分析资产在端口、协议／服务类型和地理位置上的分布。
• 安全漏洞评估：帮助识别潜在的高风险资产和异常服务。
• 网络空间画像：结合资产数据和聚合统计信息，为组织或地区生成全面的网络空间视图。

---

常见问题

Q1：什么是 DSL 查询语法？

DSL（领域专用语言）查询语法用于在 Quake 中搜索资产。查询示例包括：

• domain:"example.com"：搜索域名 example.com 下的资产。
• port:22 AND country:CN：搜索在中国暴露于端口 22 的资产。

Q2：如何获取 API Token？

登录 Quake 平台，前往 用户中心 → API Token，然后生成新的 Token。

Q3：查询结果的积分扣除机制是什么？

积分扣除机制与 API 调用扣除系统一致。根据查询频率和数据获取情况扣除积分。

---

特别声明

Quake MCP Server 旨在增强网络资产的安全性。使用本服务，即表示您承诺不从事任何可能危害计算机网络安全的活动。这些活动包括但不限于：

1. 非法入侵：未经授权访问他人网络、干扰网络正常运行或窃取网络数据。
2. 未经授权的数据访问：使用未经授权的数据，或访问未获批准的服务器／账户。
3. 非法访问网络：未经授权访问公共计算机网络或其他计算机系统，并删除、修改或添加其中存储的信息。
4. 漏洞扫描或测试：试图探查、扫描或测试他人系统或网络的弱点，或从事任何其他可能危害网络安全的行为。
5. 其他违法或非法活动：法律法规禁止的任何其他活动。

---

总结

Quake MCP Server 提供了一种高效且灵活的方式，用于收集、分析和汇总网络资产数据。通过与 AI 环境集成并利用强大的查询能力，它可以帮助安全专业人员快速收集数据，用于漏洞评估、资产画像和威胁情报。