fofa-mcp

fofa-mcp

FOFA 搜索引擎的 MCP (Model Context Protocol) 工具服务器，让 AI 助手能够直接调用 FOFA API 进行网络资产搜索。

功能

• fofa_search - FOFA 资产搜索，支持完整查询语法
• fofa_export - 导出搜索结果到文件（CSV/JSON），数据不进入上下文，避免 token 消耗
• fofa_user_info - 查询账户信息（仅官方 API）
• fofa_stats - 搜索结果统计聚合分析（仅官方 API）
• fofa_host - 查询指定主机的详细信息（仅官方 API）

使用自定义 API URL 时，仅注册 fofa_search 和 fofa_export，其余工具仅在官方 FOFA API 下可用。

安装

npx 直接运行（无需安装）

npx fofa-mcp

全局安装

npm install -g fofa-mcp

Claude Code 一键安装

claude mcp add fofa-mcp -e FOFA_API_KEY=your-api-key -- npx fofa-mcp

指定自定义 API 地址：

claude mcp add fofa-mcp -e FOFA_API_KEY=your-api-key -e FOFA_BASE_URL=https://your-api.com -- npx fofa-mcp

Go 版本（备选）

go install github.com/lulaide/fofa-mcp@latest

配置

环境变量

Claude Desktop 配置

编辑 Claude Desktop 配置文件：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "fofa": {
      "command": "npx",
      "args": ["fofa-mcp"],
      "env": {
        "FOFA_API_KEY": "your-api-key",
        "FOFA_BASE_URL": "https://fofa.info"
      }
    }
  }
}

Cursor 配置

{
  "mcpServers": {
    "fofa": {
      "command": "npx",
      "args": ["fofa-mcp"],
      "env": {
        "FOFA_API_KEY": "your-api-key"
      }
    }
  }
}

使用示例

配置完成后，你可以在 AI 助手中这样使用：

• "用 FOFA 搜索所有 domain 为 example.com 的资产"
• "将 title='登录' 的搜索结果导出到 result.csv"
• "查看我的 FOFA 账户信息"
• "统计 title='登录' 的资产国家分布"
• "查询 1.1.1.1 的主机详细信息"

fofa_search 参数

fofa_export 参数

fofa_stats 参数（仅官方 API）

fofa_host 参数（仅官方 API）

许可证

MIT License