FoFa MCP Server
About
This server provides access to FoFa API functionality through the Model Context Protocol.
Details
- Author
- help116114
- Downloads
- 511
- Categories
- Other
Jump to
- Search FoFa’s database for devices and services using custom queries.
- Retrieve user information including account details and usage statistics.
- Supports pagination with configurable page number and result size.
- Allows specifying which fields to include in search results.
- Compatible with MCP‑enabled AI assistants like Claude.
Clone the repository, install dependencies with npm install, build with npm run build, and set the environment variables FOFA_API_KEY and FOFA_EMAIL. Start the server with npm start. For integration with Claude Desktop, add the server configuration to MCP settings, including the path to the built index.js and the required environment variables.
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: ``bash
git clone https://github.com/help116114/fofa-mcp-server.git
cd fofa-mcp-server
`
2. Install dependencies:
`bash
npm install
`
3. Build the server:
`bash
npm run build
`
4. Set up your FoFa API key and email:
`bash
export FOFA_API_KEY="your-api-key-here"
export FOFA_EMAIL="your-email-here"
`
5. Start the server:
`bash
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:
`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. 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 emailSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
