Fofa MCP Server

🚀 FoFa MCP Server

A Model Context Protocol (MCP) server that provides access to FoFa API functions, allowing AI assistants to query information about internet-connected devices and services.

✨ Features

• Search Function: Search for devices and services in FoFa's database based on various queries.
• User Information: Retrieve user information from FoFa, including account details and usage statistics.

📦 Installation

Step 1: Clone the repository

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

Step 2: Install dependencies

npm install

Step 3: Build the server

npm run build

Step 4: Configure FoFa API key and email

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

Step 5: Start the server

npm start

💻 Usage Examples

MCP Integration

This server can be integrated with Claude or other MCP-compatible AI assistants. To add it to Claude Desktop or Claude.app:

Step 1: Add the server in MCP settings

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

Step 2: Restart Claude to load the new MCP server.

Tools

search_fofa

• Description: Search for devices and services in the FoFa database.
• Input Format:
  • query: FoFa search query (e.g., 'app="Apache HTTP Server"').
  • page: Page number of the results (default: 1).
  • size: Number of results per page (default: 100).
  • fields: List of fields to include in the results (e.g., ['ip', 'port', 'title']).

get_user_info

• Description: Retrieve user information from FoFa.
• Input Format: Input information.