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 调用记录。
利用步骤
- 实现/运行 MCP Server:声明
fofatool,参数query(FOFA 查询语法)、limit(默认 100)、field(ip:port/host/ip/port)。 - Handler 读取参数,构造
uncover.Options并执行 FOFA 查询,回调中收集result.IpPort(),用换行拼接后作为mcp.NewToolResultText返回。 - 在 Host 中配置 MCP Server:stdio 命令指向编译好的二进制(如
uncover_mcp_windows_amd64.exe),环境变量填 FOFA 邮箱/API Key,超时按查询量设置。 - 新建使用该 MCP Server 的对话/机器人,选择支持工具调用的模型(如 Gemini 2.5 Flash)。
- 输入自然语言目标(如“收集 example.com 的 IP 地址并去重”);LLM 生成
fofa调用,Host 执行后把结果回传,LLM 输出整理后的 IP/端口列表。 - 按需追加
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 校验与查询频率限制;敏感资产不放入公开测绘平台可检索的范围。