FoFa MCP Server

FoFa MCP 服务

一个模型上下文协议（MCP）服务，可提供 FoFa API 功能，让 AI 助手查询有关连接到互联网的设备和服务的信息。

功能

• 搜索功能：根据各种查询条件搜索 FoFa 数据库中的设备和服务。
• 用户信息：从 FoFa 获取用户信息，包括账户详情和使用统计数据。

安装

1. 克隆代码库：

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

2. 安装依赖项：

   npm install
   

3. 构建服务：

   npm run build
   

4. 设置 FoFa API 密钥和邮箱：

   export FOFA_API_KEY="your-api-key-here"
   export FOFA_EMAIL="your-email-here"
   

5. 启动服务：

   npm start
   

MCP 集成

此服务可与 Claude 或其他兼容 MCP 的 AI 助手集成。要将其添加到 Claude Desktop 或 Claude.app：

1. 将服务添加到 MCP 设置中：

   {
     "mcpServers": {
       "fofa": {
         "command": "node",
         "args": ["/path/to/fofa-mcp-server/build/index.js"],
         "env": {
           "FOFA_API_KEY": "your-api-key-here",
           "FOFA_EMAIL": "your-email-here"
         }
       }
     }
   }
   

2. 重启 Claude 以加载新的 MCP 服务。

工具

search_fofa

• 描述：搜索 FoFa 数据库中的设备和服务。
• 输入架构：
  • query：FoFa 搜索查询（例如，'app="Apache HTTP Server"'）。
  • page：结果分页的页码（默认值：1）。
  • size：每页的结果数（默认值：100）。
  • fields：要包含在结果中的字段列表（例如，['ip', 'port', 'title']）。

get_user_info

• 描述：从 FoFa 获取用户信息。
• 输入架构：输入信息。

要求

• Node.js（版本 16 或更高）
• npm（通常随 Node.js 一起安装）
• FoFa API 密钥和邮箱