About Uncover MCP
Uncover MCP connects the uncover tool to AI assistants for discovering exposed internet hosts. It supports searches through Shodan and FOFA and offers multiple output formats, for security research use.
Key features
- 01Search with Shodan and FOFA
- 02Multiple output formats
- 03AI assistant interaction
Use cases
- 01Discover internet-exposed hosts
- 02Search host data for security research
MCP support
It exposes uncover-based host search to MCP clients, including Shodan and FOFA queries and multiple output formats.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEUncover 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.