Uncover MCP

Uncover MCP is a MCP (Model Context Protocol) service implementation based on the uncover tool, designed for quickly discovering exposed hosts on the internet.

Engilsh |

Features

• Direct integration with projectdiscovery/uncover library for searching
• Support for multiple search engines (currently Shodan and FOFA)
• Multiple output format options
• Simple and easy-to-use MCP service interface
• Natural interaction with AI assistants

Installation

# Clone repository
git clone https://github.com/Co5mos/uncover-mcp
cd uncover-mcp

# Build project
go build -o uncover-mcp ./cmd/uncover-mcp

Usage

Run as an MCP service:

{
    "mcpServers": {
        "uncover-mcp": {
            "command": "./uncover-mcp",
            "args": [],
            "env": {
                "SHODAN_API_KEY": "",
                "FOFA_EMAIL": "",
                "FOFA_KEY": ""
            }
        }
    }
}

Examples

Use the following format in AI assistant:

Search using Shodan for ssl:"Uber Technologies, Inc."

Search using FOFA for app="ATLASSIAN-JIRA"

Declaration

This tool is intended for security research purposes only. Use this tool in compliance with relevant laws and regulations and the terms of use of the uncover project.

License

This project is licensed under the MIT License - see the LICENSE file