What can you do with this server?

SurveyHub-MCP is a unified MCP server that aggregates five major cyberspace asset mapping platforms — FOFA, 360 Quake, Hunter, ZoomEye, and DayDayMap — into a single interface for asset search, aggregation, and account management. FOFA * fofa_search / fofa_search_next – Asset search with standard and continuous pagination * fofa_search_stats – Statistical aggregation by protocol, port, country, etc. (throttled) * fofa_host – Host aggregation data for a specific IP/hostname * fofa_user_info – Account status, quota, and membership info 360 Quake * quake_service_search – Real-time service search (up to 500 results) * quake_service_scroll – Deep-pagination search for large datasets * quake_service_aggregation – Aggregation queries on up to 2 fields * quake_filterable_fields / quake_aggregation_fields – List available filter/aggregation fields * quake_user_info – User details, quota, and role Hunter (Personal & Enterprise) * Asset search with filtering by date, status code, and web type * Batch task creation (via query or CSV), status monitoring, CSV download, and (enterprise) JSON result pulling * User info and quota for both editions; enterprise adds whois, body, and vulnerability fields ZoomEye * zoomeye_search – Paid-account asset search with facets and sub-type filtering (v4/v6/web) * zoomeye_user_info – Subscription and points information DayDayMap * daydaymap_search – Asset search with rich query syntax covering IP, domain, geo, ICP, ASN, protocol, device, certificate, vulnerability, and organization fields Additional Features * Prompts: surveyhub_search_plan (generate multi-platform search plans) and surveyhub_query_help (check and optimize queries) * Resource references: Query syntax and API documentation for all platforms via surveyhub://reference/ URIs * Rate limiting & circuit breaking: Per-platform throttling and a circuit breaker (pauses 15s after 2 consecutive failures) * Error handling: Local parameter validation and structured error reporting for auth, rate limit, and timeout issues

How do I use SurveyHub-MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@SurveyHub-MCP show my FOFA account info" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

SurveyHub-MCP

by helGayhub233

Overview Schema Related Servers Score Discussions

Python

Remote

支持平台

平台	能力
FOFA	资产搜索、连续翻页、统计聚合、Host 聚合、账号信息
360 Quake	服务搜索、深度翻页、服务聚合、筛选字段、聚合字段、账号信息
Hunter	资产搜索、批量任务、任务状态、结果下载、结果拉取、账号信息
ZoomEye	资产搜索、账号信息
DayDayMap	资产搜索

Related MCP server: FOFA Quake Hunter MCP Server

快速开始

通过 pip 安装

要求 Python >=3.10，MCP Python SDK >=2.0.0,<3。用户无需 clone 源码，可直接从 PyPI 安装：

python -m pip install -U surveyhub-mcp

安装后可直接启动聚合 MCP Server：

surveyhub-mcp

服务同时兼容 MCP 2026-07-28 和 2025-11-25；SDK 会根据客户端自动选择 server/discover 或传统 initialize 流程。

MCP 客户端配置：

{
  "mcpServers": {
    "surveyhub": {
      "command": "surveyhub-mcp",
      "args": [],
      "env": {
        "CN_FOFA_KEY": "your_fofa_key",
        "CN_FOFA_EMAIL": "optional_fofa_email",
        "CN_QUAKE_KEY": "your_quake_key",
        "CN_ZOOMEYE_API_KEY": "your_zoomeye_api_key",
        "CN_HUNTER_ENTERPRISE_KEY": "your_hunter_enterprise_key",
        "CN_DAYDAYMAP_API_KEY": "your_daydaymap_api_key"
      }
    }
  }
}

只运行单个平台入口时：

fofa-mcp
quake-mcp
zoomeye-mcp
hunter-personal-mcp # 个人版
hunter-enterprise-mcp # 企业版
daydaymap-mcp

通过 uvx 免安装运行

如果不想提前安装，也可以在 MCP 客户端中使用 uvx 直接运行 PyPI 包：

{
  "mcpServers": {
    "surveyhub": {
      "command": "uvx",
      "args": [
        "surveyhub-mcp"
      ],
      "env": {
        "CN_FOFA_KEY": "your_fofa_key",
        "CN_FOFA_EMAIL": "optional_fofa_email",
        "CN_QUAKE_KEY": "your_quake_key",
        "CN_ZOOMEYE_API_KEY": "your_zoomeye_api_key",
        "CN_HUNTER_ENTERPRISE_KEY": "your_hunter_enterprise_key",
        "CN_DAYDAYMAP_API_KEY": "your_daydaymap_api_key"
      }
    }
  }
}

只运行单个平台入口时：

uvx --from surveyhub-mcp fofa-mcp
uvx --from surveyhub-mcp quake-mcp
uvx --from surveyhub-mcp zoomeye-mcp
uvx --from surveyhub-mcp hunter-personal-mcp
uvx --from surveyhub-mcp hunter-enterprise-mcp
uvx --from surveyhub-mcp daydaymap-mcp

从源码运行

git clone https://github.com/helGayhub233/SurveyHub-MCP.git
cd SurveyHub-MCP
uv sync
uv run surveyhub-mcp

也可以只启动单个平台：

uv run fofa-mcp
uv run quake-mcp
uv run zoomeye-mcp
uv run hunter-personal-mcp
uv run hunter-enterprise-mcp
uv run daydaymap-mcp

MCP 配置

从源码运行时，推荐使用 uv --directory 固定项目目录。使用 PyPI 包时可直接参考上方 pip 或 uvx 配置。

{
  "mcpServers": {
    "surveyhub": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/SurveyHub-MCP",
        "run",
        "surveyhub-mcp"
      ],
      "env": {
        "CN_FOFA_KEY": "your_fofa_key",
        "CN_FOFA_EMAIL": "optional_fofa_email",
        "CN_QUAKE_KEY": "your_quake_key",
        "CN_ZOOMEYE_API_KEY": "your_zoomeye_api_key",
        "CN_HUNTER_ENTERPRISE_KEY": "your_hunter_enterprise_key",
        "CN_DAYDAYMAP_API_KEY": "your_daydaymap_api_key"
      }
    }
  }
}

只使用某一个平台时，把 args 最后一个命令替换为对应入口，并只保留对应平台的 Key。

平台	单平台入口	必要环境变量
FOFA	`fofa-mcp`	`CN_FOFA_KEY`
Quake	`quake-mcp`	`CN_QUAKE_KEY`
ZoomEye	`zoomeye-mcp`	`CN_ZOOMEYE_API_KEY`
Hunter 个人版	`hunter-personal-mcp`	`CN_HUNTER_PERSONAL_KEY`
Hunter 企业版	`hunter-enterprise-mcp`	`CN_HUNTER_ENTERPRISE_KEY`
DayDayMap	`daydaymap-mcp`	`CN_DAYDAYMAP_API_KEY`

mcp.json.example 和 .env.example 提供了可直接修改的示例。

Hunter 版本路由

聚合入口会按 MCP 子进程实际收到的凭据选择 Hunter 工具族：只配置 CN_HUNTER_ENTERPRISE_KEY 时仅暴露 hunter_enterprise_*，只配置 CN_HUNTER_PERSONAL_KEY 时仅暴露 hunter_personal_*。共享的 CN_HUNTER_KEY 无法表明账户版本，因此会保留两组工具供调用者明确选择；未配置 Hunter Key 时也会保留两组 schema，用于暴露配置要求。

一般只应选择下列一种配置，不要把占位值同时填入三个变量：

账户类型	建议配置	实际暴露的工具
Hunter 企业版	`CN_HUNTER_ENTERPRISE_KEY`	`hunter_enterprise_*`
Hunter 个人版	`CN_HUNTER_PERSONAL_KEY`	`hunter_personal_*`
旧版共享配置	`CN_HUNTER_KEY`	两组 Hunter 工具

同时设置共享 CN_HUNTER_KEY 和任一版本专用 Key，也可能使两组工具同时出现，因此新配置应优先使用版本专用变量。

如果已配置企业版仍提示未配置，请检查 Key 是否放在 MCP 客户端的 mcpServers.<name>.env 中，而不是只存在于另一个终端。环境变量修改后必须重启 MCP 子进程。企业版也可直接使用 hunter-enterprise-mcp，该入口只暴露 6 个企业版工具，能进一步避免 Agent 误选个人版。如果仍调用到错误版本，返回的 error.type=wrong_hunter_edition 和 error.details.recommended_tool 会指明已配置版本及应改用的工具；不应将该错误概括为“Hunter 未配置”。

环境变量

环境变量使用 CN_ 前缀命名规范。

环境变量	说明
`CN_FOFA_KEY`	FOFA API Key
`CN_FOFA_EMAIL`	FOFA Email
`CN_QUAKE_KEY`	360 Quake API Key
`CN_ZOOMEYE_API_KEY`	ZoomEye API Key
`CN_HUNTER_KEY`	Hunter 通用 fallback API Key
`CN_HUNTER_PERSONAL_KEY`	Hunter 个人版 API Key
`CN_HUNTER_ENTERPRISE_KEY`	Hunter 企业版 API Key
`CN_DAYDAYMAP_API_KEY`	DayDayMap API Key

API Key 获取入口：

FOFA: https://fofa.info
Quake: https://quake.360.net
ZoomEye: https://www.zoomeye.org
Hunter: https://hunter.qianxin.com
DayDayMap: https://www.daydaymap.com

工具列表

下表是项目的完整能力集，不代表每个运行实例都会暴露全部工具。Hunter 工具会按上述凭据版本动态选择，单平台入口则只暴露对应平台的工具。

工具名称	所属平台	说明
`fofa_search`	FOFA	常规资产搜索
`fofa_search_next`	FOFA	连续翻页搜索
`fofa_search_stats`	FOFA	统计聚合
`fofa_host`	FOFA	Host 聚合
`fofa_user_info`	FOFA	账号信息
`quake_user_info`	Quake	用户信息
`quake_filterable_fields`	Quake	服务数据可筛选字段
`quake_service_search`	Quake	实时服务搜索
`quake_service_scroll`	Quake	深度翻页搜索
`quake_search`	Quake	兼容别名，等同于 `quake_service_scroll`
`quake_aggregation_fields`	Quake	聚合字段列表
`quake_service_aggregation`	Quake	服务聚合查询
`zoomeye_user_info`	ZoomEye	用户信息、订阅信息和积分情况
`zoomeye_search`	ZoomEye	付费账号 v2 资产搜索
`hunter_personal_search`	Hunter 个人版	资产搜索
`hunter_personal_batch_create`	Hunter 个人版	创建批量任务
`hunter_personal_batch_status`	Hunter 个人版	查询批量任务状态
`hunter_personal_batch_download`	Hunter 个人版	下载批量任务结果
`hunter_personal_user_info`	Hunter 个人版	账号信息
`hunter_enterprise_search`	Hunter 企业版	资产搜索
`hunter_enterprise_batch_create`	Hunter 企业版	创建批量任务
`hunter_enterprise_batch_status`	Hunter 企业版	查询批量任务状态
`hunter_enterprise_batch_download`	Hunter 企业版	下载批量任务结果
`hunter_enterprise_batch_pull`	Hunter 企业版	拉取批量任务结果 JSON
`hunter_enterprise_user_info`	Hunter 企业版	账号信息
`daydaymap_search`	DayDayMap	资产搜索

工具返回结构化结果：成功时包含 ok=true、platform 和 data 或 text；失败时包含 ok=false、platform 和 error。meta.execution 还会返回 request_id、脱敏请求指纹、传输状态、重试安全性、配额风险与数据完整性，便于 AI 区分“确认空结果”与“执行结果未知”。

计费型资产搜索默认使用 retry_mode=safe_only：仅在请求确认未发送的连接或连接池失败时自动重试；写入或读取超时会返回 final_state=indeterminate，不会自动重发。相同指纹的请求在未知状态后 60 秒内会被请求账本抑制；只有明确接受重复扣费风险时才应设置 force_retry=true。

资源提示

服务会暴露查询语法和 API 文档资源，URI 前缀为 surveyhub://reference/，例如：

surveyhub://reference/fofa-syntax
surveyhub://reference/quake-syntax
surveyhub://reference/hunter-syntax
surveyhub://reference/zoomeye-syntax
surveyhub://reference/daydaymap-api

聚合入口额外提供两个 Prompt：

surveyhub_search_plan：根据目标和平台生成资产搜索计划
surveyhub_query_help：检查并优化指定平台查询语句

请求限制

项目会对可在本地判断的参数做校验或节流。账号等级、积分额度、CSV 文件内容等仍以平台返回为准。

平台	工具	控制方式
FOFA	`fofa_search_stats`	进程内节流，`5 秒/次`
FOFA	`fofa_host`	进程内节流，`1 秒/次`
FOFA	`fofa_search`, `fofa_search_next`	本地校验，返回 `body` 时 `size <= 500`
FOFA	`fofa_search`, `fofa_search_next`	本地校验，返回 `cert` 或 `banner` 时 `size <= 2000`
FOFA	`fofa_search`, `fofa_search_next`	不使用未文档化响应字段控制重试；`full=true` 且供应商未明确确认时，返回 `completeness.state=unknown`
Quake	全部工具	进程内节流，`5 秒/次`
Quake	`quake_service_search`, `quake_service_scroll`	参数 schema 限制，`size <= 500`
Quake	`quake_service_search`, `quake_service_scroll`	根据官方可筛选字段清单移除非法 `include/exclude` 字段并返回 warning
Quake	搜索与聚合工具	默认 `safe_only` 仅重试确认未发送的失败；读/写超时不自动重发，`aggressive` 模式的多次 HTTP 尝试会返回可能重复消耗配额的 warning
Quake	`quake_service_aggregation`	本地校验聚合字段最多 2 个，参数 schema 限制 `size <= 10000`
ZoomEye	`zoomeye_search`	仅调用付费账号 `POST /v2/search`，参数 schema 限制 `pagesize <= 10000`
Hunter 个人版	全部搜索工具	基于 API Key 的 SQLite 跨进程共享节流，`1 秒/次`
Hunter 个人版	搜索和批量查询语句	默认将 `field="value"` 转为 `field=="value"` 精确查询；可用 `exact_search=false` 保留平台包含语义
Hunter 个人版	批量任务	工具描述提示平台限制：`all <= 10`，`ip/domain/company <= 100`
Hunter 企业版	全部搜索工具	基于 API Key 的 SQLite 跨进程共享节流，`1 秒/次`
Hunter 企业版	搜索和批量查询语句	默认将 `field="value"` 转为 `field=="value"` 精确查询；可用 `exact_search=false` 保留平台包含语义
Hunter 企业版	批量任务	工具描述提示平台限制：`all <= 10`，`ip/domain/company <= 10000`
DayDayMap	`daydaymap_search`	本地拒绝空白查询；限制 `page <= 10000`、`page_size <= 10000`、`page × page_size <= 10000`
全部平台	全部 HTTP 请求	进程内熔断保护，连续 3 次可恢复失败后暂停 15 秒

搜索响应的顶层 meta 包含 MCP 实际执行信息，例如 original_query、executed_query、attempts 和 partial_data；顶层 warnings 保留不会使请求失败、但可能影响完整性的供应商或参数提示。

FOFA 和 Quake 的频率控制、以及全部平台的熔断状态保存在单 MCP 进程内；Hunter 频率控制会按 API Key 通过本地 SQLite 在多个 MCP 进程之间共享。

API 文档

已整理的接口文档位于 docs/api/：

docs/api/fofa_api.md
docs/api/quake_api.md
docs/api/zoomeye_api.md
docs/api/hunter_personal_api.md
docs/api/hunter_enterprise_api.md
docs/api/daydaymap_api.md

版本发布和迭代记录见 CHANGELOG.md。

项目结构

src/
  surveyhub_mcp/
    server.py             # 聚合 MCP 入口
    fofa.py               # FOFA 工具
    quake.py              # Quake 工具
    zoomeye.py            # ZoomEye 工具
    hunter_personal.py    # Hunter 个人版工具
    hunter_enterprise.py  # Hunter 企业版工具
    daydaymap.py          # DayDayMap 工具
    reference.py          # MCP resources 和 prompts
    common.py             # 共享编码、HTTP、错误处理和节流工具

手动编译

uv sync
uv run python -m compileall src/surveyhub_mcp
uv build --wheel

注意事项

本项目仅供学习和技术研究使用，严禁用于任何商业或非法用途。

请只在合法授权范围内使用本项目，并遵守各平台的 API 服务条款和额度限制。

许可证

MIT License，见 LICENSE。

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Tools

View all tools

Related MCP Servers

ZoomEye MCP Serverofficial
Search Security Developer Tools
zoomeye-ai
A
license
B
quality
C
maintenance
MCP server for querying the ZoomEye API
Updated 9 months ago (2025-11-27 01:39 UTC)
3
80
MIT
FOFA Quake Hunter MCP Server
Search Security Web Scraping
RuoJi6
A
license
A
quality
C
maintenance
An MCP server that enables AI models to query FOFA, 360 Quake, and Hunter cyberspace mapping platforms for asset discovery and security research. It supports natural language parameter configuration and provides comprehensive search tools for retrieving IP, port, and domain data.
Updated 6 days ago (2026-08-13 01:42 UTC)
3
6
MIT
FOFA MCP Server
Search Networking & Infrastructure Penetration Testing
intbjw
F
license
-
quality
B
maintenance
MCP server for querying the FOFA API, enabling network asset search and account information retrieval.
Updated 4 months ago (2026-04-25 08:59 UTC)
8
touful-vuln-search-mcp
Penetration Testing Search
touful
F
license
-
quality
B
maintenance
Unified vulnerability search MCP server for penetration testing agents, integrating 5 data sources (NVD, OSV, EPSS, CISA KEV, Exploit-DB+GitHub) and 10 MCP tools for CVE query, keyword search, batch query, EPSS scoring, KEV checking, exploit search, and comprehensive assessment with Chinese output.
Updated a month ago (2026-07-16 10:27 UTC)
2

View all related MCP servers

Related MCP Connectors

mcp-server
MCP server for Pentest-Tools.com: run scans, manage findings and reports via your preffered LLM.
Shodan Internetdb
Shodan InternetDB MCP — wraps Shodan InternetDB (internetdb.shodan.io)
qsearch
Multi-engine search for AI agents. Trust scoring, local corpus, MCP-native. Self-hostable, BYOK.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/helGayhub233/SurveyHub-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server