mcp-recon

mcp-recon

mcp-recon（前身为 Tellix）是一款对话式侦察界面和 MCP 服务，由 httpx 和 asnmap 提供支持。只需提问即可。

概述

mcp-recon 在自然语言与 HTTP 基础设施分析之间搭建了桥梁。它通过 Model Context Protocol (MCP) 提供侦察工具，让你可以通过任何兼容的 AI 界面（例如 Claude Desktop）执行 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 提供三种主要的侦察工具：

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 专为作为 Docker 容器运行而设计，可通过 MCP 协议与 Claude Desktop 搭配使用。

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 标准输入泄漏：即使作为库使用，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。现已更名为 mcp-recon，以更好地遵循安全工具采用的模型上下文协议（MCP）命名惯例。指向旧仓库名称的所有链接都会重定向到新名称，但请尽可能更新你的引用。

许可证

MIT 许可证。完整详情请参阅 LICENSE 文件。

参考资料与相关项目

• 模型上下文协议 SDK
• mcp-go
• httpx
• asnmap
• Claude Desktop