JinDaGe - mcp_subfinder_server MCP Details

article

README

🚀 MCP 子域发现服务器

一个模型上下文协议（MCP）服务器，封装了 ProjectDiscovery 的 subfinder 工具，借助 JSON-RPC API 提供强大的子域枚举功能，能高效发现目标域名的子域。

🚀 快速开始

本项目提供了通过二进制文件和 Docker 两种安装方式，你可以根据自己的需求进行选择。

通过二进制文件安装

# 下载并编译项目
git clone https://github.com/copyleftdev/mcp-subfinder.git
cd mcp-subfinder
go build -o mcp-subfinder .

# 启动服务器
./mcp-subfinder --port=8080

通过 Docker 安装

# 构建 Docker 镜像
make docker

# 运行容器
make docker-run

✨ 主要特性

MCP Subfinder 服务器具备以下强大功能：

子域枚举：借助多种数据源，全面发现目标域名的所有子域。
递归扫描：支持可选的递归模式，可深度遍历子域。
过滤配置：允许指定使用或排除的数据源，灵活定制扫描范围。
超时控制：可设置任务超时时间，保障扫描效率。

📚 详细文档

使用说明

启动服务器后，可通过以下接口与服务器进行交互：

JSON-RPC 接口

示例请求

{
  "jsonrpc": "2.0",
  "method": "enumerateSubdomains",
  "params": {
    "domain": "example.com",
    "timeout": 120,
    "recursive": true,
    "maxDepth": 2,
    "sourcesFilter": ["github", "dnsdumpster"],
    "excludeSourcesFilter": ["waybackarchive"]
  },
  "id": 1
}

参数说明

| 参数 | 类型 | 描述 | 默认值 | |------|------|------|-------| | domain | string | 需要枚举的域名（必填） | - | | timeout | int | 枚举任务超时时间，单位秒 | 120 | | recursive | bool | 是否递归检查发现的子域 | false | | maxDepth | int | 递归的最大深度 | 2 | | sourcesFilter | array | 指定使用的数据源列表 | - | | excludeSourcesFilter | array | 需要排除的数据源列表 | - |

健康检查接口

curl http://localhost:8080/health

架构

flowchart LR
    Client([客户端]) -->|JSON-RPC| MCP[MCP 服务器]
    MCP -->|初始化/工具列表| Client
    MCP -->|处理请求| SF[Subfinder 包装器]
    SF -->|配置| CFG[provider-config.yaml]
    SF -->|调用| PD[ProjectDiscovery Subfinder]
    PD -->|被动数据源| API1[公共及私人API]
    PD -->|结果| SF
    SF -->|处理后结果| MCP
    MCP -->|JSON 响应| Client

项目结构

mcp-subfinder.go：主服务文件，包含服务器启动和请求处理逻辑。
subdomain_enumerator.go：子域枚举核心逻辑，整合了 ProjectDiscovery 的 subfinder 工具。
config.go：配置管理模块，支持自定义端口、数据源过滤等设置。
Dockerfile：用于构建 Docker 镜像的文件。
Makefile：项目构建和运行脚本，简化命令行操作。

mcp_subfinder_server