README

FOFA MCP Server

基于 MCP (Model Control Protocol)的 FOFA API 查询服务器，提供简单易用的 FOFA 数据查询接口。

功能特点

• 支持 FOFA API 的基础查询功能

• 提供完整的字段信息查询选项

• 支持查询账户信息

• 基于异步 HTTP 客户端，性能优异

• 使用 MCP 协议，便于与其他系统集成

环境要求

• Python >= 3.11

• FOFA API 密钥

• cline

安装

1. 克隆项目到本地：

git clone https://github.com/intbjw/fofa-mcp-server.git
cd fofa-mcp-server

1. 安装依赖：

pip install -r requirements.txt

或者使用 Poetry：

poetry install

配置

1. 下载插件

使用 cline 进行配置，在 vscode 中下载插件

1. 进行模型配置

我这里选择的阿里云的qwen-coder，也可以使用本地大模型。

1. 配置fofa-mcp-server

编写配置文件

{
  "mcpServers": {
    "fofa-mcp-server": {
      "command": "python3",
      "args": [
        "/path/to/fofa-mcp-server/main.py"
      ],
      "env": {
        "FOFA_KEY": "API KEY"
      }
    }
  }
}

提示fofa-mcp-server MCP server connected 配置成功

使用演示

2025-03-14 17-49-49.mp4

API 说明

1. FOFA 查询

fofa_search_tool(query: str, fields: str = "", size: int = 50) -> dict

参数说明：

• query: FOFA 查询语句

• fields: 查询字段，可选值：

  • ""（默认）：返回基础字段信息

  • "all"：返回所有可用字段信息

• size: 返回结果数量，默认 50 条

返回数据格式：

{
    "summary": str,  # 查询统计信息
    "data": List[Dict]  # 查询结果列表
}

2. 查询账户信息

fofa_userinfo_tool() -> dict

返回 FOFA 账户的详细信息。

字段说明

基础字段（默认）

• IP

• 端口

• 协议

• 主机名

• 域名

• ICP 备案号

• 网站标题

• 产品名

• 版本号

• 最后更新时间

完整字段（fields="all"）

包含基础字段，以及：

• 国家代码

• 国家名

• 地区

• 城市

• 经度

• 纬度

• ASN 编号

• ASN 组织

• 操作系统

• 服务器

• JARM 指纹

• Header

• Banner

• 基础协议

• URL 链接

• 证书相关信息

• JA3S 指纹

• TLS 版本

• 产品分类

• 域名 CNAME

注意事项

1. 请确保 FOFA API 密钥有效且具有足够的查询权限

2. 注意遵守 FOFA 的 API 使用限制和规范

3. 建议合理设置查询结果数量，避免消耗过多积分

TODO

• 查询账号信息

• 执行用户输入语句

• 支持大模型生成查询语句

• 模糊语句查询

许可证

贡献

欢迎提交 Issue 和 Pull Request！