♧ Godown 安全知识树

MCP Server 封装 FOFA:LLM Host 按工具描述自动发起自然语言资产查询

pentest/recon · verified

一句话结论

把 FOFA 查询封装成 MCP Server 的一个 tool(名称、描述、输入 schema),MCP Host 启动时把所有工具说明拼进 system prompt,LLM 根据用户自然语言选择 fofa 工具并输出固定 JSON({"tool":"fofa","arguments":{"query":"...","field":"ip"}}),Client 用 session.call_tool 执行 Handler(内部调用 uncover 的 fofa agent),把 IP/端口结果回传 LLM 汇总,即可用一句自然语言完成域名资产测绘。

原理

  • MCP(Model Context Protocol)采用 Host / Client / Server 三层:Host 与 LLM 交互、维护对话并解析工具调用;Client 负责协议握手、会话与 JSON-RPC;Server 声明并提供确定性能力(tools/resources/prompts)。
  • Server 端用 mcp.NewTool("fofa", mcp.WithDescription(...), mcp.WithString("query", mcp.Required(), ...), mcp.WithNumber("limit", ...), mcp.WithString("field", ...)) 声明工具;s.AddTool(fofaTool, fofa.Handler) 把 Handler 绑定到工具。
  • Host 启动时调用 server.list_tools() 收集全部工具,把每个工具的 name/description/input_schema 格式化成文本(参数名、说明、required 标记)拼进 system prompt,并规定“需要调用工具时只能输出固定 JSON”。
  • LLM 根据工具描述和用户问题选择工具并生成 JSON;Host 解析 JSON,通过 MCP Client 的 session.call_tool(tool_name, arguments) 发 JSON-RPC 给 Server;Server 执行 Handler 并把结果作为 tool 结果返回;Host 再把结果作为上下文交给 LLM 生成自然语言总结。
  • FOFA Handler 只是把参数转换为 uncover.Options{Agents: []string{"fofa"}, Queries: []string{query}, Limit, MaxRetry, Timeout},用 ExecuteWithCallback 收集 result.IpPort()。因此“自然语言→FOFA 语法”的转换由 LLM 完成,Server 只做确定性查询执行,攻击面小且行为可预测。
  • 该模式可把任意安全工具(FOFA/Shodan/Censys/Quake、nmap、空间测绘 API)包装成 MCP tool,让 LLM 按目标自主串联信息收集步骤。

触发条件

  • 已有支持 MCP 的 Host(如 Cherry Studio、Claude Desktop 等)和可加载的 MCP Server(stdio 或 SSE)。
  • Server 能读取 FOFA 凭据(FOFA_EMAIL/FOFA_KEY 或配置项),并有访问 FOFA API 的网络出口。
  • LLM 具备 tool calling/结构化输出能力,Host 能把工具描述注入 system prompt。
  • 目标在授权范围内;FOFA 查询会消耗账号额度并留下 API 调用记录。

利用步骤

  1. 实现/运行 MCP Server:声明 fofa tool,参数 query(FOFA 查询语法)、limit(默认 100)、field(ip:port/host/ip/port)。
  2. Handler 读取参数,构造 uncover.Options 并执行 FOFA 查询,回调中收集 result.IpPort(),用换行拼接后作为 mcp.NewToolResultText 返回。
  3. 在 Host 中配置 MCP Server:stdio 命令指向编译好的二进制(如 uncover_mcp_windows_amd64.exe),环境变量填 FOFA 邮箱/API Key,超时按查询量设置。
  4. 新建使用该 MCP Server 的对话/机器人,选择支持工具调用的模型(如 Gemini 2.5 Flash)。
  5. 输入自然语言目标(如“收集 example.com 的 IP 地址并去重”);LLM 生成 fofa 调用,Host 执行后把结果回传,LLM 输出整理后的 IP/端口列表。
  6. 按需追加 field=host/ip:port、limit、FOFA 语法(domain="example.com"、cert="..."、region="..." 等)迭代查询,或把多个 MCP tool 串联到同一对话。

PoC

MCP Server 端最小结构(Go,基于 mark3labs/mcp-go 与 projectdiscovery/uncover):

s := server.NewMCPServer("Uncover MCP", "0.0.1", server.WithLogging())

fofaTool := mcp.NewTool("fofa",
    mcp.WithDescription("Use FOFA search engine to find exposed hosts"),
    mcp.WithString("query", mcp.Required(), mcp.Description("FOFA search query")),
    mcp.WithNumber("limit", mcp.Description("Limit the number of results")),
    mcp.WithString("field", mcp.Description("Return field format (ip:port, host, ip, port)")),
)
s.AddTool(fofaTool, func(ctx context.Context, req mcp.CallToolRequest) (*mcp.CallToolResult, error) {
    query := req.Params.Arguments["query"].(string)
    limit := 100
    if v, ok := req.Params.Arguments["limit"].(float64); ok { limit = int(v) }

    opts := uncover.Options{
        Agents: []string{"fofa"}, Queries: []string{query},
        Limit: limit, MaxRetry: 2, Timeout: 30,
    }
    client, err := uncover.New(&opts)
    if err != nil { return nil, err }

    var results []string
    err = client.ExecuteWithCallback(ctx, func(r sources.Result) {
        results = append(results, r.IpPort())
    })
    if err != nil { return nil, err }
    return mcp.NewToolResultText(strings.Join(results, "\n")), nil
})

Host 侧工具调用契约(LLM 输出):

{"tool":"fofa","arguments":{"query":"domain=\"example.com\"","limit":100,"field":"ip"}}

变体与关联

  • 变体:在 Server 端同时注册 shodan/censys/quake 等多个 tool,让 LLM 按资产类型选择数据源并交叉验证。
  • 变体:把 nmap/httpx 等本地工具也封装成 MCP tool,形成“空间测绘 → 端口/指纹 → 漏洞验证”的自动化链。
  • 变体:用 SSE/HTTP 传输替代 stdio,支持远程 MCP Server;需额外做认证与出站限制。
  • 关联:[[ai-security-agent-security-ai-pentest-evidence-driven-pipeline]](MCP/Skill 串联渗透流程与人工复核)、[[pentest-recon-hidden-ip-c-segment-fofa-region-keyword]](FOFA 查询语法与隐藏 IP 段发现)、[[pentest-c2-mcp-c2-llm-orchestration]](把 C2 能力封装成 MCP 工具的编排模式)。
  • 边界:LLM 可能生成非法 JSON 或错误 FOFA 语法,需要 schema 校验/重试;FOFA 结果可能是 CDN/证书关联 IP,不等同于目标直连 IP;查询消耗 API 额度。

检测与防御

  • 检测:从内网/终端发往 FOFA API 的查询流量;Host 进程拉起异常 MCP Server 二进制并读取 FOFA 凭据;LLM 对话中出现固定 JSON 工具调用与批量 domain=/cert= 查询。
  • 检测:MCP Server 配置文件中明文保存的 FOFA_EMAIL/FOFA_KEY;未授权的 MCP 二进制或来源不明的 Server 命令。
  • 防御:FOFA Key 最小权限/定期轮换,禁止写入代码或共享配置;对 MCP Server 二进制做来源校验与签名/哈希白名单;限制终端到测绘 API 的出站;对 MCP 工具调用做日志与额度告警;资产查询仅限授权范围。
  • 加固:MCP Host 只加载可信 Server;对 tool 参数做 schema 校验与查询频率限制;敏感资产不放入公开测绘平台可检索的范围。