Uncover MCP

🚀 Uncover MCP

Uncover MCP is a service implementation based on MCP (Model Context Protocol), combined with the uncover tool, aiming to quickly discover exposed hosts on the Internet.

🚀 Quick Start

Uncover MCP is a service implementation that combines the power of MCP (Model Context Protocol) and the uncover tool. It's designed to rapidly identify exposed hosts across the internet.

✨ Features

• Direct Integration: Directly integrates the projectdiscovery/uncover library for searching.
• Multiple Search Engines: Supports multiple search engines (currently Shodan and FOFA).
• Diverse Output Formats: Provides various output format options.
• User - friendly MCP Interface: Offers a simple and easy - to - use MCP service interface.
• Natural Interaction: Enables natural interaction with AI assistants.

📦 Installation

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

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

💻 Usage Examples

Basic Usage

Run as an MCP service:

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

Advanced Usage

Use the following format in an AI assistant:

Use Shodan to search for ssl:"Uber Technologies, Inc."

Use FOFA to search for app="ATLASSIAN-JIRA"

📚 Documentation

⚠️ Important Note

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

📄 License

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