🚀 FoFa MCP 服务器

FoFa MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务，它提供了对 FoFa API 功能的访问。借助该服务器，AI 助手能够轻松查询互联网连接设备和服务的相关信息。

✨ 主要特性

• 搜索功能：可依据各类查询条件，在 FoFa 的数据库里精准搜索设备和服务。
• 用户信息：能从 FoFa 获取用户信息，涵盖账户详情与使用统计等内容。

📦 安装指南

克隆仓库

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

安装依赖项

npm install

构建服务器

npm run build

配置 FoFa API 密钥和电子邮件

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

启动服务器

npm start

💻 使用示例

MCP 集成

此服务器能够与 Claude 或其他兼容 MCP 的 AI 助手进行集成。若要将其添加到 Claude Desktop 或 Claude.app 中，可按以下步骤操作：

基础用法

在 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"
      }
    }
  }
}

高级用法

重启 Claude 以加载新的 MCP 服务器，从而使配置生效。

📚 详细文档

工具

search_fofa

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

get_user_info

• 描述：获取 FoFa 的用户信息。
• 输入格式：输入信息。