nickpending/mcp-recon

> **mcp-recon** (formerly Tellix) is a conversational reconnaissance interface and MCP server powered by httpx and asnmap. Just ask.
Overview
**mcp-recon** bridges the gap between natural language and HTTP infrastructure analysis. It exposes reconnaissance tools through the Model Context Protocol (MCP), allowing you to perform web domain reconnaissance via any compatible AI interface, such as Claude Desktop.
Features
- **Conversational Commands**: Execute reconnaissance through simple text prompts
- **MCP Server**: Integrates with Claude Desktop or other MCP-compatible tools
- **Multiple Analysis Modes**: Choose from lite and full reconnaissance levels
- **Standalone ASN Lookup**: Query IPs, ASNs, or organizations directly
- **Docker Ready**: Run in an isolated container for security and portability
- **Powered by httpx**: Utilizes ProjectDiscovery's robust reconnaissance tools
- **Bug Workarounds**: Automatically handles httpx's stdin/stdout leakage issue
- **MCP Prompts**: Includes predefined prompts like http_lite_scan and katana_command_generator for streamlined operations
What is the Model Context Protocol (MCP)?
The Model Context Protocol (MCP) is an open standard developed by Anthropic that enables AI assistants to interact with external tools, systems, and data sources. MCP provides a standardized interface for AI models to access and execute functions, retrieve resources, and utilize prompts, facilitating seamless integration between AI applications and various software environments.
MCP Prompts in mcp-recon
In MCP, a **prompt** is a predefined template that guides AI assistants in performing specific tasks. Prompts can accept dynamic arguments, include context from resources, and chain multiple interactions, enabling structured and efficient workflows.
**mcp-recon** includes the following prompts:
- **http_lite_scan**: Initiates a quick HTTP scan for basic information about specified targets.
- **katana_command_generator**: Generates optimized Katana crawl commands based on reconnaissance goals and desired thoroughness.
Quick Start Guide
**mcp-recon** provides three main reconnaissance tools:
1. Quick/Lightweight Reconnaissance (http_lite_recon)
Fast, lightweight HTTP fingerprinting that provides essential information with minimal overhead.
**Example:**
2. Full Reconnaissance (http_full_recon)
Comprehensive metadata collection including page previews, headers, certificates, and technology detection.
**Example:**
3. ASN Lookup (asn_lookup)
Standalone lookup of IPs, ASNs, or organization names using ProjectDiscovery's asnmap library.
**Example:**
Installation
**mcp-recon** is designed to run as a Docker container to be used with Claude Desktop via the MCP protocol.
MCP Configuration
**mcp-recon** runs as a standalone MCP server. Add it to your MCP configuration like so:
Using an .env file:
Your .env should contain:
Troubleshooting
**No Results Returned**:
- Domain is publicly accessible