FoFa MCP Server
About
This server provides access to FoFa API functionality through the Model Context Protocol.
Explore
- 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.
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
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.
