MCP Subfinder Server

🚀 MCP サブドメイン発見サーバー

モデルコンテキストプロトコル（MCP）サーバーで、ProjectDiscovery の subfinder ツールをラップし、JSON - RPC API を通じて強力なサブドメイン列挙機能を提供します。

🚀 クイックスタート

この MCP サブドメイン発見サーバーは、ProjectDiscovery の subfinder ツールをラップし、JSON - RPC API を通じてサブドメイン列挙機能を提供します。以下に、インストールと使用方法を説明します。

✨ 主な機能

MCP Subfinder サーバーは以下の機能を提供します：

1. サブドメイン列挙：複数のデータソースを通じて、対象ドメインのすべてのサブドメインを発見します。
2. 再帰的スキャン：オプションの再帰モードで、サブドメインを深く探索します。
3. フィルター設定：使用するまたは除外するデータソースを指定できます。
4. タイムアウト制御：タスクのタイムアウト時間を設定して、効率を確保します。

📦 インストール

バイナリファイルによるインストール

# プロジェクトをダウンロードしてコンパイル
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

💻 使用例

サーバー起動後の操作

サーバーを起動した後、以下のインターフェースを通じて操作できます。

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

貢献

すべてのサブドメイン列挙作業は ProjectDiscovery によって行われています。

プロジェクト構成

• mcp-subfinder.go：メインサービスファイルで、サーバーの起動とリクエスト処理のロジックが含まれています。
• subdomain_enumerator.go：サブドメイン列挙の核心ロジックで、ProjectDiscovery の subfinder ツールを統合しています。
• config.go：設定管理モジュールで、カスタムポート、データソースフィルターなどの設定をサポートしています。
• Dockerfile：Docker イメージを構築するためのファイルです。
• Makefile：プロジェクトの構築と実行スクリプトで、コマンドライン操作を簡素化します。

貢献者

copyleftdev