MCP Recon

MCP Recon

Web セキュリティの偵察と分析に対応する包括的な Model Context Protocol（MCP）サーバーです。このツールキットは、標準的なサイバーセキュリティ偵察手法に沿った Python ネイティブの実装を通じて、サイバーセキュリティの専門家に不可欠な偵察機能を提供します。

🚀 特長

📊 1. 情報収集（パッシブ偵察）

• WHOIS 情報：ドメインの登録情報と所有者の詳細
• ドメイン履歴：レピュテーションと過去のデータの分析

🔍 2. DNS 分析（インフラストラクチャの調査）

• DNS レコードの検索：包括的な DNS 列挙（A、AAAA、MX、NS、TXT、SPF、DMARC）
• 逆引き DNS 検索：IP アドレスからホスト名を解決
• パッシブサブドメイン列挙：crt.sh 経由で Certificate Transparency ログを調査（ステルス）
• アクティブサブドメイン列挙：subdomains.txt のワードリストを使用した DNS ブルートフォース調査

🌐 3. ネットワーク偵察（アクティブスキャン）

• IP 情報：ジオロケーション、ISP、ネットワークの詳細
• 稼働確認：応答分析を伴う HTTP/HTTPS 接続テスト
• ポートスキャン：複数のスキャンモードに対応した高度な Nmap 統合

🔒 4. Web アプリケーション分析（アプリケーション層）

• TLS 証明書分析：SSL/TLS 証明書の検査と検証
• HTTP ヘッダー分析：セキュリティヘッダーの評価と情報漏えいの検出
• テクノロジー検出：Web フレームワークとテクノロジーのフィンガープリンティング
• URL 抽出：Web クロールとリンクの検出

🛠 インストール

前提条件

• Python 3.10+
• UV パッケージマネージャー（スクリプトによって自動的にインストールされます）
• Nmap（スクリプトによって自動的にインストールされます）

クイックインストール

Windows（PowerShell）

.\install.ps1

Linux/macOS

chmod +x install.sh
./install.sh

Claude Desktop の設定

MCP Web Reconnaissance Server に接続するには、この設定を Claude Desktop の設定に追加してください。

Windows の設定

{
  "mcpServers": {
    "recon": {
      "command": "C:\\Users\\YOUR_USERNAME\\.local\\bin\\uv.exe",
      "args": [
        "--directory",
        "C:\\Users\\YOUR_USERNAME\\path\\to\\MCP_Recon",
        "run",
        "python",
        "main.py"
      ]
    }
  }
}

Linux/macOS の設定

{
  "mcpServers": {
    "recon": {
      "command": "/home/YOUR_USERNAME/.local/bin/uv",
      "args": [
        "--directory",
        "/home/YOUR_USERNAME/path/to/MCP_Recon",
        "run",
        "python",
        "main.py"
      ]
    }
  }
}

次のプレースホルダーを置き換えてください：

• YOUR_USERNAME を実際のユーザー名に置き換えます
• path/to/MCP_Recon をクローンしたリポジトリの実際のパスに置き換えます

設定ファイルの場所：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

🚀 使用方法

利用可能なツール（偵察手法に準拠）

1. 情報収集（パッシブ偵察）

• whois_info - WHOIS 情報を取得
• domain_history - ドメインのレピュテーションと履歴を確認

2. DNS 分析（インフラストラクチャの調査）

• dns_records - ドメインのすべての DNS レコードを取得
• reverse_dns - 逆引き DNS 検索を実行
• subdomain_enum_passive - Certificate Transparency（crt.sh）経由でパッシブサブドメインを調査
• subdomain_enum_active - DNS ブルートフォースを使用してアクティブサブドメインを列挙

3. ネットワーク偵察（アクティブスキャン）

• ip_information - 包括的な IP 情報を取得
• check_alive - HTTP/HTTPS 経由でホストが応答するかを確認
• port_scan - Nmap を使用した高度なポートスキャン

4. Web アプリケーション分析（アプリケーション層）

• tls_certificate - TLS 証明書を分析
• http_headers - HTTP セキュリティヘッダーを分析
• detect_technologies - Web テクノロジーを検出
• extract_urls - Web ページから URL を抽出

🔧 設定

カスタム User-Agent

特定の識別情報が必要なバグバウンティプログラム向けに、HTTP ベースのツールでは任意の user_agent パラメーターを指定できます。指定すると、対象へのすべての HTTP リクエストでデフォルトの User-Agent が置き換えられます。

例：

# Default User-Agent
http_headers("https://example.com")

# Custom User-Agent for bug bounty programs
http_headers("https://example.com", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36 bug-bounty")

カスタム User-Agent に対応するツール：

• http_headers - HTTP ヘッダーの分析
• detect_technologies - テクノロジーのフィンガープリンティング
• extract_urls - URL の抽出／クロール
• check_alive - ホストの接続確認

🔧 ワードリスト

サブドメインのワードリストのカスタマイズ

サブドメインの列挙は、次の 2 つの方法でカスタマイズできます。

1. ワードリストファイルを編集する

プロジェクトルートにある subdomains.txt ファイルを編集して、サブドメインを追加／削除します。

www
api
admin
test
dev
staging
# Add your custom subdomains here

2. Claude Desktop のチャットでカスタムワードリストを指定する

ポートスキャンのオプション

ポートスキャナーでは、さまざまな状況に合わせて最適化されたモードを利用できます。

• "common"：一般的なサービス（21,22,23,25,53,80,443 など）
• "top100"：最も一般的なポート上位 100 個（初期調査におすすめ）
• "top1000"：ポート上位 1000 個（包括的な検出）
• "80,443,8080"：特定のポート（対象を絞ったスキャン）
• "1-1000"：ポート範囲（内部ネットワークのスキャン）

🏗 アーキテクチャ

プロジェクト構成

mcp-recon/
├── main.py                 # MCP server entry point with organized tool categories
├── subdomains.txt          # Default subdomain wordlist (customizable)
├── tools/
│   ├── info_tools.py       # Information gathering utilities (WHOIS, domain history)
│   ├── dns_tools.py        # DNS and domain reconnaissance
│   ├── network_tools.py    # Network scanning and analysis
│   └── web_tools.py        # Web application analysis
├── install.ps1            # Windows installation script
├── install.sh             # Linux/macOS installation script
├── pyproject.toml          # Python project configuration
└── README.md              # This documentation

📝 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については LICENSE ファイルをご覧ください。

⚠️ 免責事項

このツールは、正当なセキュリティ調査、ペネトレーションテスト、バグバウンティ活動のみを対象としています。ネットワーク、システム、アプリケーションをスキャンまたはテストする前に、適切な許可を得ていることを確認する責任はユーザーにあります。このツールの悪用について、作者は一切責任を負いません。

常に責任ある情報開示の慣行に従い、バグバウンティプログラムのスコープ制限を尊重してください。