nslookup

适用于 nslookup.io 的 MCP 服务
通过模型上下文协议，进行 DNS 查询、SSL 证书检查、安全扫描、GEO（AI 就绪度）评分、域名情报查询，以及管理你自己的监控账户。

网站 · API 文档 · npm · 联系

这是什么？

nslookup.io MCP 服务为任何支持 MCP 的 AI 助手（Claude、ChatGPT、Cursor、Windsurf 等）提供直接访问 nslookup.io 的 DNS、证书、安全和监控工具的能力。用自然语言提问——“检查 github.com 的 DNS 状况”或“我的哪些 SSL 证书最早到期？”——助手便会为你调用相应工具。

共 23 个工具，分为两组：

• 17 个公共工具——DNS、SSL、安全、GEO 和域名情报查询，匿名即可使用，无需账户和 API 密钥。
• 6 个 my_ 账户工具——读取你自己的 nslookup.io 监控账户（运行时间、DNS、WHOIS、SSL、传播情况、BIMI/VMC 监控）。这些工具始终会显示，但需要登录才能使用。

跳转到连接开始设置，或查看工具参考了解完整列表。

连接

有两种连接方式。任选一种——请参阅下方说明。

	托管（推荐）	本地（npx / stdio）
端点	https://mcp.nslookup.io/mcp	npx -y @nslookup-io/mcp-server
传输方式	Streamable HTTP（远程）	stdio（在你的计算机上运行）
安装	无需安装	需要 Node.js 18+
17 个公共工具	✅ 匿名使用	✅ 匿名使用
6 个 my_ 账户工具	✅ 首次使用时通过浏览器登录（OAuth）	❌ 本地不可用——请使用托管连接器

如果你想使用自己的监控数据，请选择托管端点——只有这种模式会在浏览器中为你登录 my_ 账户工具。本地模式无需任何设置，非常适合使用 17 个公共工具。

连接以使用账户（portal）工具

要使用你自己的 NsLookup.io 监控数据（6 个 my_ 账户工具），请添加托管连接器并登录。无需 API 密钥——只需通过浏览器登录一次（OAuth），使用你的 nslookup.io 账户完成身份验证。

Claude Code（CLI）

claude mcp add --transport http nslookup https://mcp.nslookup.io/mcp

然后调用一个账户工具——例如询问_“显示我的监控概览”_。系统会打开浏览器登录窗口；登录一次后，所有 6 个 my_ 工具便可使用（客户端会记住你的登录状态）。

Claude Desktop / claude.ai——添加 URL 为 https://mcp.nslookup.io/mcp 的自定义连接器，然后按提示登录。

.mcp.json（项目配置）或任何支持 HTTP 的客户端：

{ "mcpServers": { "nslookup": { "type": "http", "url": "https://mcp.nslookup.io/mcp" } } }

通过同一端点，17 个公共工具可立即使用——只有在首次访问你自己的数据时才需要登录。

托管（推荐）

托管端点是一个远程 Streamable-HTTP 服务。公共工具可立即使用；首次调用 my_ 工具时，支持 OAuth 的客户端会打开浏览器窗口，让你登录 nslookup.io 账户（参见登录）。

Claude Code（CLI）

claude mcp add --transport http nslookup https://mcp.nslookup.io/mcp

Claude Desktop / claude.ai（自定义连接器）

1. 打开 设置 → 连接器
2. 点击 添加自定义连接器
3. 名称：nslookup — URL：https://mcp.nslookup.io/mcp
4. 点击 添加

或者将其放入 .mcp.json（项目）/客户端的 MCP 配置中：

{
  "mcpServers": {
    "nslookup": {
      "type": "http",
      "url": "https://mcp.nslookup.io/mcp"
    }
  }
}

ChatGPT

1. 打开 设置 → 已连接的应用（或 工具与集成）
2. 点击 添加自定义集成 / 添加 MCP 服务
3. 名称：nslookup — URL：https://mcp.nslookup.io/mcp
4. 保存

Cursor / Windsurf（以及任何支持 HTTP 的客户端）

添加到你的 MCP 配置（.cursor/mcp.json、~/.codeium/windsurf/mcp_config.json 等）：

{
  "mcpServers": {
    "nslookup": {
      "type": "http",
      "url": "https://mcp.nslookup.io/mcp"
    }
  }
}

本地（npx / stdio）

在你的计算机上通过 stdio 运行服务。仅限公共工具——全部 17 个公共工具均可在无需身份验证的情况下使用。若要访问你自己的监控数据（my_ 账户工具），请使用托管连接器并登录——账户工具无法通过本地传输使用。

Claude Code（CLI）

# Global (all projects)
claude mcp add nslookup --scope user -- npx -y @nslookup-io/mcp-server

# Or for a single project
claude mcp add nslookup --scope project -- npx -y @nslookup-io/mcp-server

Claude Desktop — 添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "nslookup": {
      "command": "npx",
      "args": ["-y", "@nslookup-io/mcp-server"]
    }
  }
}

Cursor（.cursor/mcp.json）/ Windsurf（~/.codeium/windsurf/mcp_config.json）：

{
  "mcpServers": {
    "nslookup": {
      "command": "npx",
      "args": ["-y", "@nslookup-io/mcp-server"]
    }
  }
}

⚠️ 只使用一个 nslookup 条目

配置托管条目或本地条目——不要同时配置两者。如果同时注册了两个名为 nslookup 的 MCP 服务（例如，一个托管连接器加上一个本地 npx 条目），工具调用可能会路由到错误的服务，导致行为无法预测。选择所需的模式，并移除另一个。

登录

• 17 个公共工具——无需账户、密钥，也无需登录。它们调用的是公开、无状态且无需身份验证的端点。
• 6 个 my_ 账户工具——读取你的私人监控数据，因此需要登录：
  • 托管端点 → 浏览器 OAuth。 该服务是 OAuth 2.1 资源服务。无凭据调用 my_ 工具会返回带有 WWW-Authenticate 挑战的 401，随后支持 OAuth 的客户端（Claude 网页版/桌面版、Claude Code 等）会引导你在浏览器中通过 nslookup.io 身份提供方（Keycloak）登录。无需 API 密钥——登录一次后，客户端会记住你的登录状态。其他功能仍可匿名使用——只有在首次访问自己的数据时才需要登录。参见连接账户（门户）工具。

工具参考

公共工具（17 个——匿名使用）

DNS

工具	描述
dns_lookup	查询域名的所有常见 DNS 记录（A、AAAA、NS、MX、TXT、CNAME、SOA）
dns_record	查询指定类型的 DNS 记录——支持全部 53 种类型（HTTPS、DNSKEY、TLSA、SPF 等）
dns_propagation	检查 DNS 在 18 个以上全球服务器（Cloudflare、Google、Quad9、区域服务器、权威服务器）上的传播情况
webservers	获取域名的 IPv4 和 IPv6 地址
dns_change_review	应用前审核拟议的 DNS 更改：与当前 DNS 的差异、带修复建议的基于规则的检查结果，以及 0–100 的风险评分

域名情报

工具	描述
rdap_lookup	查询 IP、AS 编号或域名的注册数据（RDAP）——所有者组织、网络范围、RIR、联系人、日期
hosting_report	查询网站的托管方：托管提供商、CDN/代理、DNS 提供商、邮件服务器、服务器位置、SSL 颁发者
status_page	读取公共状态页（通过别名或自定义域名）：总体状态、组件、活动事件

DNS 健康与安全

工具	描述
dns_health	执行 DNS 健康审计（涵盖 DNSSEC、MX、卫生状况、TTL、名称服务器、CAA、运维成熟度等 39 项检查），并按严重程度加权评分
ssl_certificate	检查 SSL/TLS 证书：颁发者、过期时间、证书链有效性、密码套件强度、SAN 域名、TLS 版本
bimi_vmc	检查 BIMI 记录和 VMC（Verified Mark Certificate）：徽标 URL、商标信息、证书过期时间
bimi_check	仅检查 BIMI DNS 记录（速度更快——跳过获取 VMC 证书）
security_scan	扫描域名的安全问题：SPF/DKIM/DMARC、Cookie 安全性、DNS 配置错误
domain_scanner	扫描域名的电子邮件安全状况（SPF、DKIM、DMARC、BIMI），并为各项指标评分
uptime_check	单次 HTTP 在线状态检查：状态、响应时间、HTTP 状态码
uptime_check_multi	从 7 个全球位置检查网站是否在线：阿姆斯特丹、悉尼、伦敦、法兰克福、德里、华沙、南卡罗来纳州

GEO（AI 就绪度）

工具	描述
geo_checker	检查域名的 GEO（生成式引擎优化）评分：AI 爬虫访问权限、结构化数据、实体信号、内容可提取性，以及按优先级排序的建议

账户工具（6 个——需要登录）

这些 my_ 工具会读取你自己的 nslookup.io 监控账户。它们始终会列出，但需要登录后才能调用。

工具	描述
my_overview	账户健康状况概览——汇总的 0–100 评分，包含各子系统的细分信息，以及你的限额/配额
my_monitors	列出你所有类型的监控项（在线状态、API、DNS、WHOIS、传播、证书、VMC）
my_incidents	列出所有监控类型的未解决事件（或近期所有事件），并按状态/来源汇总
my_uptime_history	查询一个监控项（按 id 或 URL）的在线状态和响应时间历史记录，时间范围可配置
my_dns_changes	查看受监控域名的近期 DNS 变更及其风险评估（0–100 评分、严重性计数）
my_certificates	SSL 证书过期概览——按警报级别统计数量，并按最早过期时间排列证书

支持的 DNS 记录类型

A、AAAA、AFSDB、APL、AXFR、CAA、CDNSKEY、CDS、CERT、CNAME、CSYNC、DHCID、DLV、DNAME、DNSKEY、DS、EUI48、EUI64、HINFO、HIP、HTTPS、IPSECKEY、IXFR、KEY、KX、LOC、MX、NAPTR、NS、NSEC、NSEC3、NSEC3PARAM、NXT、OPENPGPKEY、OPT、PTR、RP、RRSIG、SIG、SMIMEA、SOA、SPF、SRV、SSHFP、SVCB、TA、TKEY、TLSA、TSIG、TXT、URI、ZONEMD

DNS 服务器

cloudflare、google、quad9、opendns、authoritative，以及位于南非、澳大利亚、印度、荷兰、加拿大、美国、巴西、乌克兰和俄罗斯的区域服务器。

配置

环境变量	默认值	描述
NSLOOKUP_API_URL	https://www.nslookup.io	nslookup.io API 的基础 URL
MCP_RESOURCE_URL	(request-derived)	（HTTP 服务）此资源服务器明确的公共源，用作 OAuth 元数据中的 issuer/resource/authorization_servers 值。未设置时，源会根据传入请求（X-Forwarded-Proto + host）推导。在生产环境中，将其设置为固定的公共 URL（例如 https://mcp.nslookup.io）。
KEYCLOAK_ISSUER	https://auth.nslookup.io/realms/nslookup-io	（HTTP 服务）用于验证登录 JWT（JWKS、issuer、exp）的 OAuth 令牌签发者
KEYCLOAK_REALM_URL	(= KEYCLOAK_ISSUER)	（HTTP 服务）Keycloak realm 基础 URL，其 /.well-known/openid-configuration 提供实际的 authorization_endpoint/token_endpoint。对于 Keycloak，这与签发者相同，因此通常无需设置。
KEYCLOAK_CLIENT_ID	nslookup-io-mcp	（HTTP 服务）DCR 适配层返回的预先注册的公共 Keycloak 客户端 ID。此客户端必须已存在于 realm 中；未启用 Keycloak DCR。

托管式 OAuth 登录的底层工作原理

托管服务是一个 OAuth 2.1 资源服务器：在没有凭据的情况下调用 my_ 工具会返回一个带有 WWW-Authenticate 挑战的 401，该挑战指向 /.well-known/oauth-protected-resource，随后支持 OAuth 的 MCP 客户端会引导你通过 nslookup.io 身份提供方登录。

无需启用 Keycloak DCR，DCR 专用客户端（Claude 网页版/桌面版、Claude Code）也可以登录。该服务还充当自身的 OAuth 授权服务器来提供元数据：GET /.well-known/oauth-authorization-server 返回的 issuer 等于此服务自身的源，而 authorization_endpoint/token_endpoint 指向实际的 Keycloak端点（从 realm 的 OpenID 配置获取，并采用缓存与静态回退机制），registration_endpoint 则设置为 <origin>/register。由于通告的 issuer 是此服务自身，因此会计算 {issuer}/register 的客户端会访问我们在 POST /register（也支持 POST /oauth/register）提供的动态客户端注册（DCR）适配层。该适配层会忽略提交的元数据，并返回一个预先注册的公共 Keycloak 客户端（KEYCLOAK_CLIENT_ID，默认值为 nslookup-io-mcp），其 token_endpoint_auth_method: "none"，并回显请求的重定向 URI。浏览器登录和 PKCE code→令牌交换会直接在 Keycloak 上进行。realm 中必须已存在一个使用 KEYCLOAK_CLIENT_ID 的公共客户端；不会使用或公开 Keycloak DCR 端点。

## 示例提示词

连接后，可以尝试向 AI 助手提问：

• "github.com 的 DNS 记录是什么？"
• "检查 google.com 的 MX 记录"
• "my-domain.com 的 A 记录是否已完成 DNS 传播？"
• "cloudflare.com 解析到哪些 IP 地址？"
• "显示 example.com 的 DNSKEY 记录"
• "检查 amazon.com 的 SPF 记录"
• "对 example.com 执行 DNS 健康检查"
• "cloudflare.com 的 DNSSEC 状态是什么？"
• "检查 my-domain.com 的 DNS 健康评分——是否存在严重问题？"
• "检查 github.com 的 SSL 证书"
• "google.com 是否有 BIMI 记录？"
• "对 example.com 执行安全扫描"
• "https://cloudflare.com 目前可以访问吗？"
• "检查全球各地是否都能访问 github.com"
• "检查全球所有服务上的 example.com NS 记录的 DNS 传播情况"
• "检查 github.com 的 GEO 评分"
• "example.com 是否针对 AI 搜索引擎进行了优化？"
• "cloudflare.com 屏蔽了哪些 AI 爬虫？"
• "IP 8.8.8.8 的所有者是谁？"
• "查询 AS13335 的注册数据"
• "github.com 使用哪家托管服务？"
• "在应用前，帮我检查一下这个针对 example.com 的 DNS 变更：..."
• "扫描 example.com 的电子邮件安全配置（SPF、DKIM、DMARC）"
• "nslookup-io 状态页面是否报告了任何事件？"

登录 nslookup.io 账户后，还可以提问：

• "我目前的监控状态有多健康？"
• "列出我的所有监控项——是否有停机或即将到期的项目？"
• "我有未解决的事件吗？"
• "显示 https://myapp.com 过去 48 小时的正常运行时间历史记录"
• "最近我的域名是否有任何有风险的 DNS 变更？"
• "我的哪些 SSL 证书最早到期？"

反馈

我们很期待听到你的反馈！在 nslookup.io，我们正在为所有人打造快速、可靠且免费的 DNS 查询工具和监控平台，服务对象涵盖开发者、系统管理员和普通互联网用户。

你的反馈有助于我们不断改进。无论你发现了 Bug、有功能建议，还是只想分享想法，我们都乐于倾听。联系我们。

许可证

Apache 2.0