mcp-recon

mcp-recon

mcp-recon（旧 Tellix）は、httpx と asnmap を活用した対話型偵察インターフェース兼 MCP サーバーです。聞くだけで使えます。

概要

mcp-recon は、自然言語と HTTP インフラストラクチャ分析の間のギャップを埋めます。これはModel Context Protocol（MCP）を通じて偵察ツールを公開し、Claude Desktop など任意の互換 AI インターフェースから Web ドメインの偵察を実行できるようにします。

機能

• 対話型コマンド: シンプルなテキストプロンプトで偵察を実行できます
• MCP サーバー: Claude Desktop やその他の MCP 互換ツールと統合できます
• 複数の分析モード: ライトとフルの偵察レベルから選択できます
• スタンドアロン ASN ルックアップ: IP、ASN、組織を直接クエリできます
• Docker 対応: セキュリティと移植性のために分離されたコンテナで実行できます
• httpx を活用: ProjectDiscovery の堅牢な偵察ツールを利用しています
• バグの回避策: httpx の stdin/stdout リーク問題を自動的に処理します
• MCP プロンプト: 操作を効率化するために、http_lite_scan や katana_command_generator などの定義済みプロンプトを含みます

Model Context Protocol（MCP）とは？

Model Context Protocol（MCP）は、Anthropic が開発したオープン標準であり、AI アシスタントが外部ツール、システム、データソースと連携できるようにします。MCP は、AI モデルが関数にアクセスして実行し、リソースを取得し、プロンプトを利用するための標準化されたインターフェースを提供し、AI アプリケーションとさまざまなソフトウェア環境の間のシームレスな統合を実現します。

mcp-recon の MCP プロンプト

MCP において、プロンプトとは、AI アシスタントが特定のタスクを実行する際に導くための定義済みテンプレートです。プロンプトは動的な引数を受け入れ、リソースからのコンテキストを含め、複数のやり取りを連鎖させることができ、構造化された効率的なワークフローを可能にします。

mcp-recon には次のプロンプトが含まれます：

• http_lite_scan: 指定されたターゲットに関する基本情報のための迅速な HTTP スキャンを開始します。
• katana_command_generator: 偵察の目的と希望する網羅性に基づいて、最適化された Katana クロールコマンドを生成します。

クイックスタートガイド

mcp-recon は 3 つの主要な偵察ツールを提供します：

1. クイック/軽量偵察（http_lite_recon）

最小限のオーバーヘッドで必須情報を提供する、高速で軽量な HTTP フィンガープリンティングです。

例：

User: "Using quick http recon, what's the status code for example.com?"

AI: "I checked example.com and it's currently returning a 200 OK status code, indicating the site is up and functioning normally. It's being served from an Nginx web server on IP 93.184.216.34."

2. フル偵察（http_full_recon）

ページプレビュー、ヘッダー、証明書、テクノロジー検出を含む包括的なメタデータ収集です。

例：

User: "Using full http recon, what certificates is www.google.com using?"

AI: "Based on my analysis, www.google.com is using a TLS 1.3 certificate issued by Google Trust Services. The certificate was issued on March 20, 2025, and is valid until June 12, 2025. It was specifically issued for 'www.google.com' and uses the TLS_AES_128_GCM_SHA256 cipher suite."

3. ASN ルックアップ（asn_lookup）

ProjectDiscovery の asnmap ライブラリを使用した、IP、ASN、組織名のスタンドアロンルックアップです。

例：

User: "Who owns ASN 14421?"

AI: "ASN 14421 is operated by 'PPLINKNET' in the US."

インストール

# Clone the repository
git clone https://github.com/nickpending/mcp-recon.git
cd mcp-recon

# Build the Docker image
docker build -t mcp/recon -f Dockerfile .

mcp-recon は、MCP プロトコルを介して Claude Desktop と共に使用するために、Docker コンテナとして実行するように設計されています。

MCP 設定

mcp-recon はスタンドアロンの MCP サーバーとして実行されます。次のように MCP 設定に追加してください：

"mcp-recon": {
  "command": "docker",
  "args": [
    "run",
    "--rm",
    "-i",
    "mcp/recon"
  ]
}

.env ファイルを使用する場合：

"mcp-recon": {
  "command": "docker",
  "args": [
    "run",
    "--rm",
    "-i",
    "--env-file", "/Users/yourname/.config/mcp-recon.env",
    "mcp/recon"
  ]
}

.env には次の内容を含める必要があります：

PDCP_API_KEY=your_projectdiscovery_api_key

トラブルシューティング

結果が返されない場合:

• ドメインが公開アクセス可能である
• 正しいツール（http_lite_recon、http_full_recon、asn_lookup）を指定している
• ターゲットドメインがスキャンをブロックしていない

パフォーマンスの問題:

• より速い結果を得るには http_lite_recon から始めてください
• 一度にスキャンするドメインを減らすとパフォーマンスが向上します

既知の問題

• httpx の Stdin リーク: httpx ライブラリは、ライブラリとして使用されている場合でも stdin を読み取ろうとします。mcp-recon は os.Stdin を保護して MCP への干渉を防ぎます。
• ASN のサイレント障害: Asn = true であっても、httpx は IP の拡充に失敗することがあります。mcp-recon には公式の asnmap Go ライブラリを使用したフォールバックが含まれています。

セキュリティに関する考慮事項

• 所有しているか、テストの許可を得ているドメインのみをスキャンしてください
• full_recon モードは完全なページコンテンツを取得します — 慎重に使用してください
• 対象システムに影響を与えないよう、レート制限を検討してください

スクリーンショット

この例では、www.google.com に対するクイック偵察リクエストを示しており、ステータスコード、タイトル、サーバーの詳細、IP アドレスを自然言語クエリから返しています。

この例では、www.microsoft.com に対する完全な偵察を示しており、TLS 設定、ヘッダー、CDN、セキュリティに関する所見を含んでいます。

名称変更のお知らせ

このプロジェクトは以前 Tellix という名称でした。セキュリティツールで使用されている Model Context Protocol (MCP) の命名規則に合わせるため、mcp-recon に改名されました。以前のリポジトリ名へのリンクはすべて新しい名前にリダイレクトされますが、可能な場合は参照を更新してください。

ライセンス

MIT License。詳細については LICENSE ファイルを参照してください。

参考資料と関連情報

• Model Context Protocol SDK
• mcp-go
• httpx
• asnmap
• Claude Desktop