FoFa MCP 服务器

一个提供访问FoFa API功能的模型上下文协议（MCP）服务器，允许AI助手查询有关联网设备和服务的信息。

功能

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

安装

1. 克隆仓库：
   bash
   git clone https://github.com/help116114/fofa-mcp-server.git
   cd fofa-mcp-server

2. 安装依赖项：
   bash
   npm install

3. 构建服务器：
   bash
   npm run build

4. 设置您的FoFa API密钥和电子邮件：
   bash
   export FOFA_API_KEY="your-api-key-here"
   export FOFA_EMAIL="your-email-here"

5. 启动服务器：
   bash
   npm start

MCP 集成

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

1. 将服务器添加到您的MCP设置中：
   json
   {
   "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密钥和电子邮件