Back to MCP directory
publicPublicdnsLocal runtime

uncover-mcp

Uncover MCP是基于uncover工具的MCP服务实现,用于快速发现互联网上暴露的主机,支持多搜索引擎和输出格式。

article

README

🚀 Uncover MCP 简介

Uncover MCP 是一个基于 MCP (模型上下文协议) 的服务实现,它巧妙结合了 uncover 工具,致力于快速发现互联网上暴露的主机,为网络安全研究等领域提供有力支持。

英文 | 中文

✨ 主要特性

  • 直接集成 projectdiscovery/uncover 库进行搜索,高效便捷。
  • 支持多个搜索引擎,目前涵盖 Shodan 和 FOFA,扩大搜索范围。
  • 提供多种输出格式选项,满足不同用户需求。
  • 拥有简单易用的 MCP 服务接口,降低使用门槛。
  • 可与 AI 助手自然交互,提升使用体验。

📦 安装指南

# 克隆仓库
git clone https://github.com/Co5mos/uncover-mcp
cd uncover-mcp

# 构建项目
go build -o uncover-mcp ./cmd/uncover-mcp

💻 使用示例

基础用法

作为 MCP 服务运行:

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

高级用法

在 AI 助手中使用以下格式:

使用 Shodan 搜索 ssl:"Uber Technologies, Inc."
使用 FOFA 搜索 app="ATLASSIAN-JIRA"

📄 声明说明

此工具仅用于安全研究目的。请严格遵守相关法律法规及 uncover 项目的服务条款使用本工具。

📄 许可证

该项目遵循 MIT 许可证,查看 LICENSE 文件以获取详细信息。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client