Subdomain Finder MCP

subdomain-finder-mcp

面向 AI 助手的被动子域名查找工具：实时查询证书透明度日志（certspotter、crt.sh），并通过 Cloudflare DNS over HTTPS 检查 DNS。

这是一个用于漏洞赏金和安全侦察中子域枚举的 Model Context Protocol（MCP）服务。它读取公开的证书透明度（CT）日志，对名称去重，处理通配符证书，并报告每个主机的首次出现时间、最近出现时间和颁发者。随后，它还可以解析这些主机，标记哪些主机可用、哪些主机有悬空 CNAME。无需 API 密钥。

被动且只读

• 它只读取公开的 CT 日志和公开 DNS，不会向目标服务器发送任何内容。
• 不进行端口扫描、HTTP 探测或暴力破解字典攻击。
• 仅对你拥有或获准测试的域名使用，例如漏洞赏金计划范围内的域名。

工具

工具	返回内容
find_subdomains	从 CT 日志中查找域名的去重主机名，并提供首次出现时间、最近出现时间、有效期至、证书数量、颁发者和通配符标记。可选检查最多 40 个名称的 DNS。
resolve_subdomains	查询最多 40 个主机的 A、AAAA 和 CNAME 链。标记可用、NXDOMAIN、无记录和悬空 CNAME，识别 CNAME 后面的云服务，并检测通配符 DNS。
get_certificate_history	查询某个主机的证书：颁发者、有效期、所有 SAN、吊销状态和 SHA-256，以及首次和最近签发时间、使用过的颁发者。
summarize_attack_surface	将域名的 CT 主机名按开发和测试、预发布、管理、API、身份验证、邮件、远程访问、存储和旧系统分组，并提供命名集群、颁发者和最新名称。

每个结果都包含结构化 JSON、一段摘要、as_of、source（CT 或 DNS 查询 URL）和 more（bugbountyreality.com 上对应的工具）。

它掌握而你的模型不了解的信息

• 域名当前的子域名。新主机在获取证书后几分钟内就会出现在 CT 日志中；模型的训练数据已过时数月，而且通常没有这些主机的信息。
• 当前可解析的主机、指向已删除云资源的 CNAME，以及区域是否配置了通配符 DNS。
• 证书历史：每个名称首次获取证书的时间、签发证书的 CA，以及当前证书的过期时间。
• 如何正确读取 CT 数据：合并预证书和证书记录，排除电子邮件 SAN 和范围外名称，并将 *. 条目作为通配符报告，而不是主机。

安装

托管版（Claude.ai 自定义连接器、ChatGPT 开发者模式）

粘贴此 URL。无需令牌或注册。

https://subdomain-finder-mcp.lipmichal.workers.dev/mcp

Claude Code

claude mcp add --transport http subdomain-finder https://subdomain-finder-mcp.lipmichal.workers.dev/mcp

也可以通过 stdio 在本地运行：

claude mcp add subdomain-finder -- npx -y github:theluckystrike/subdomain-finder-mcp

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "subdomain-finder": { "command": "npx", "args": ["-y", "github:theluckystrike/subdomain-finder-mcp"] }
  }
}

Cursor

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "subdomain-finder": { "url": "https://subdomain-finder-mcp.lipmichal.workers.dev/mcp" }
  }
}

VS Code

添加到 .vscode/mcp.json：

{
  "servers": {
    "subdomain-finder": { "type": "http", "url": "https://subdomain-finder-mcp.lipmichal.workers.dev/mcp" }
  }
}

本地 stdio 版本需要 Node 20 或更高版本。本地版本使用你自己的 IP 查询 CT 和 DNS，因此拥有单独的速率限制额度。

示例提示词

• “从证书透明度日志中查找 hackerone.com 的子域名，并告诉我哪些可用。”
• “以下哪些主机有悬空 CNAME：assets.example.com、docs.example.com、status.example.com？”
• “显示 api.example.com 的证书历史。今年他们更换 CA 了吗？”
• “总结 example.com 的攻击面。有没有预发布、管理或 VPN 主机？”
• “包含已过期证书，并列出 example.com 下首次出现于 2020 年之前的主机。”

数据来源

均为公开来源，无需密钥。完整列表及抓取日期见 DATA_SOURCES.md。

• SSLMate certspotter CT Search API（api.certspotter.com），包含未过期证书。主要来源。
• crt.sh，包含已过期证书。备用来源；当 include_expired 为 true 时使用。
• Cloudflare DNS over HTTPS（cloudflare-dns.com/dns-query）。

局限性

• 证书透明度只会显示获得公开信任证书的名称。使用通配符证书（*.example.com）的主机或未启用 TLS 的主机不会按名称显示。结合其他被动数据源，才能获得完整覆盖。
• certspotter 的免密套餐会按 IP 限流（观测到 x-ratelimit-limit: 10）。结果会缓存一小时，工具每次调用最多读取 5 页；当 certspotter 限流时，会回退到 crt.sh。如果两者都限流，错误信息会提示等待几分钟。
• crt.sh 经常响应缓慢或过载，相隔几分钟的两次调用可能会返回不同的行（其数据库副本存在延迟）。调用会在 25 秒后超时，重试一次，然后显示明确的错误信息。
• 对于规模很大的域名，只会返回前几页；结果会说明是否已截断。
• 每次调用最多检查 40 台主机的 DNS。“悬空 CNAME”只是需要在授权范围内核实的线索，并不能证明存在漏洞。

更多

这些工具的网页版、子域名接管检查器和手动侦察清单，详见 bugbountyreality.com。另请参阅证书透明度查询和子域名枚举清单。

属于 Zovo MCP 系列：https://mcp.zovo.one

开发

npm install
npm test            # builds, then runs the fixture tests against saved CT and DNS payloads
node scripts/smoke-stdio.mjs   # live stdio check, one real call per tool
npx wrangler deploy            # Cloudflare Worker, Streamable HTTP at /mcp

许可证

MIT

同一作者的更多数据服务

每个服务都免费、无需 API 密钥，并提供可粘贴到 Claude 或 ChatGPT 中的托管 URL。

server	tools	hosted URL
cups-to-grams-mcp	convert_ingredient, search_ingredients, scale_recipe, convert_oven_temperature	https://cups-to-grams-mcp.lipmichal.workers.dev/mcp
dscr-loan-calculator-mcp	calculate_dscr, max_loan_for_target_dscr, rent_needed_for_target_dscr, compare_scenarios, amortization_summary	https://dscr-loan-calculator-mcp.lipmichal.workers.dev/mcp
gold-price-per-gram-mcp	get_gold_price_per_gram, get_metal_prices, calculate_jewelry_value, convert_gold_units	https://gold-price-per-gram-mcp.lipmichal.workers.dev/mcp
lake-level-mcp	search_lakes, get_lake_level, get_lake_history, compare_lakes	https://lake-level-mcp.lipmichal.workers.dev/mcp
minimum-wage-mcp	get_minimum_wage, list_upcoming_increases, compare_states, annual_income_at_minimum_wage	https://minimum-wage-mcp.lipmichal.workers.dev/mcp
no-tax-on-overtime-mcp	calculate_overtime_deduction, calculate_tips_deduction, calculate_senior_deduction, estimate_tax_savings, explain_eligibility	https://no-tax-on-overtime-mcp.lipmichal.workers.dev/mcp
paycheck-calculator-mcp	calculate_take_home_pay, compare_states_take_home, salary_to_hourly, hourly_to_salary, get_federal_tax_brackets	https://paycheck-calculator-mcp.lipmichal.workers.dev/mcp
uk-income-tax-salary-mcp	calculate_uk_take_home, get_uk_tax_bands, compare_salaries, marginal_rate_at_income	https://uk-income-tax-salary-mcp.lipmichal.workers.dev/mcp
us-federal-holidays-business-days-mcp	list_federal_holidays, is_business_day, add_business_days, count_business_days, invoice_due_date	https://us-federal-holidays-business-days-mcp.lipmichal.workers.dev/mcp
ab-test-sample-size-calculator-mcp	calculate_sample_size, estimate_test_duration, test_ab_significance, fisher_exact_test, check_peeking_risk	https://ab-test-sample-size-calculator-mcp.lipmichal.workers.dev/mcp
aca-premium-tax-credit-calculator-mcp	get_federal_poverty_level, calculate_premium_tax_credit, check_subsidy_cliff, get_aptc_repayment_cap	https://aca-premium-tax-credit-calculator-mcp.lipmichal.workers.dev/mcp
ap-score-distributions-mcp	get_ap_score_distribution, estimate_ap_percentile, compare_ap_exams, list_ap_exams, estimate_ap_score_from_composite	https://ap-score-distributions-mcp.lipmichal.workers.dev/mcp
car-loan-interest-deduction-calculator-mcp	calculate_car_loan_interest_deduction, calculate_salt_deduction, get_tax_brackets_and_standard_deduction, calculate_child_tax_credit	https://car-loan-interest-deduction-calculator-mcp.lipmichal.workers.dev/mcp
estate-gift-tax-exemption-calculator-mcp	get_exemption_amounts, calculate_estate_tax, check_gift, compare_years	https://estate-gift-tax-exemption-calculator-mcp.lipmichal.workers.dev/mcp
recipe-nutrition-calculator-mcp	lookup_ingredient_nutrition, calculate_recipe_nutrition, round_nutrition_label, scale_recipe_nutrition	https://recipe-nutrition-calculator-mcp.lipmichal.workers.dev/mcp
retirement-contribution-limits-2027-mcp	get_contribution_limits, calculate_max_contribution, get_social_security_cola, compare_years	https://retirement-contribution-limits-2027-mcp.lipmichal.workers.dev/mcp
section-179-deduction-calculator-mcp	calculate_section_179, calculate_bonus_depreciation, get_vehicle_depreciation_limits, calculate_asset_loan_payment	https://section-179-deduction-calculator-mcp.lipmichal.workers.dev/mcp
student-loan-repayment-assistance-plan-calculator-mcp	calculate_rap_payment, compare_rap_vs_standard, get_federal_loan_limits, get_plan_transition_dates	https://student-loan-repayment-assistance-plan-calculator-mcp.lipmichal.workers.dev/mcp
uk-statutory-sick-pay-maternity-pay-calculator-mcp	calculate_statutory_sick_pay, calculate_statutory_maternity_pay, get_minimum_wage_rates, check_eligibility	https://uk-statutory-sick-pay-maternity-pay-calculator-mcp.lipmichal.workers.dev/mcp

付费后台集合（发票、增值税、PDF、电子表格）位于 https://mcp.zovo.one