uncover MCP Server

Use This MCP server To

Discover exposed internet hosts using Shodan and FOFA search engines Integrate internet host discovery into AI assistant workflows Generate reports of exposed hosts in multiple output formats Automate security reconnaissance by querying internet-wide exposed hosts Provide real-time internet host data to LLM-powered security tools

README

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

uncover-mcp FAQ

How do I install uncover-mcp?

Clone the GitHub repo, then build with 'go build -o uncover-mcp ./cmd/uncover-mcp'.

Which search engines does uncover-mcp support?

It supports Shodan and FOFA for internet host discovery.

How do I configure API keys for uncover-mcp?

Set environment variables like SHODAN_API_KEY and FOFA_EMAIL before running the server.

Can uncover-mcp output results in different formats?

Yes, it supports multiple output format options for flexible integration.

How does uncover-mcp interact with AI assistants?

It provides a simple MCP service interface enabling natural interaction with AI models.

Is uncover-mcp limited to specific MCP clients?

No, it is a standard MCP server compatible with any MCP client following the protocol.

What programming language is uncover-mcp written in?

It is implemented in Go for performance and ease of deployment.

Can uncover-mcp be extended to support other search engines?

Yes, its modular design allows adding support for additional search engines.