README

基本能力

产品定位

FOFA MCP Server 是一个专门用于 FOFA 数据查询的服务器，旨在通过 MCP 协议提供高效、易用的 API 查询接口。

核心功能

• 支持 FOFA API 的基础查询功能
• 提供完整的字段信息查询选项
• 支持查询账户信息
• 基于异步 HTTP 客户端，性能优异
• 使用 MCP 协议，便于与其他系统集成

适用场景

• 网络安全研究
• 资产探测
• 漏洞扫描
• 数据分析和挖掘

工具列表

• fofa_search_tool: 用于执行 FOFA 查询，支持自定义查询字段和结果数量。
• fofa_userinfo_tool: 用于查询 FOFA 账户的详细信息。

常见问题解答

1. 如何确保 FOFA API 密钥有效？
2. 请确保 FOFA API 密钥有效且具有足够的查询权限。
3. 如何避免消耗过多积分？
4. 建议合理设置查询结果数量。
5. 如何遵守 FOFA 的 API 使用限制和规范？
6. 请仔细阅读 FOFA 的 API 使用文档，确保符合其使用规范。

使用教程

使用依赖

• 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. 下载插件并配置模型：
2. 在 VSCode 中下载插件并进行模型配置。
3. 配置 fofa-mcp-server：
4. 编写配置文件并确保 fofa-mcp-server MCP server connected 提示出现。
5. 使用演示视频进行验证。

API 说明

FOFA 查询

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

查询账户信息

fofa_userinfo_tool() -> dict

许可证

None