Fofa MCP Server

🚀 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 的用戶信息。
• 輸入格式：輸入信息。