FoFa MCP Server

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

Features

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

Installation

1. Clone the repository:

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

2. Install dependencies:

   npm install
   

3. Build the server:

   npm run build
   

4. Set up your FoFa API key and email:

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

5. Start the server:

   npm start
   

MCP Integration

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

1. Add the server to your 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"
         }
       }
     }
   }
   

2. Restart Claude to load the new MCP server.

Tools

search_fofa

• Description: Search FoFa's database for devices and services.
• Input Schema:
  • query: FoFa search query (e.g., 'app="Apache HTTP Server"').
  • page: Page number for results pagination (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: Get user information from FoFa.
• Input Schema: Input information。

Requirements

• Node.js (version 16 or higher)
• npm (usually comes with Node.js)
• FoFa API key and email