MCP Subfinder Server

🚀 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 服務器具備以下強大功能：

1. 子域枚舉：藉助多種數據源，全面發現目標域名的所有子域。
2. 遞歸掃描：支持可選的遞歸模式，可深度遍歷子域。
3. 過濾配置：允許指定使用或排除的數據源，靈活定製掃描範圍。
4. 超時控制：可設置任務超時時間，保障掃描效率。

📚 詳細文檔

使用說明

啟動服務器後，可通過以下接口與服務器進行交互：

JSON-RPC 接口

示例請求

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

參數說明

健康檢查接口

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：項目構建和運行腳本，簡化命令行操作。

🔧 技術細節

所有繁重的子域枚舉工作由 ProjectDiscovery 完成。

📄 許可證

本項目遵循 MIT 許可證。

版本信息