README

FOFA MCP 服务器

基于 MCP（模型控制协议）的 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 编码器也可以与本地大模型一起使用。

1. 配置 fofa mcp 服务器

编写配置文件

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

提示：fofa-mcp-server MCP 服务器已连接 配置成功

示例使用

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 指纹
• 标头
• Banner
• 基本协议
• URL 链接
• 证书相关信息
• JA3S 指纹
• TLS 版本
• 产品类别
• 域名 CNAME

注意事项

1. 请确保 FOFA API 密钥有效且具有足够的查询权限
2. 注意遵守 FOFA 的 API 使用限制和规范
3. 建议合理设置查询结果数量，避免消耗过多积分

全部

• [x] 查询账户信息
• [x] 执行用户输入语句
• [] 支持生成大型模型查询语句
• [] 模糊语句查询

许可证

贡献

欢迎提交 Issue 和 Pull Requests！