使用说明
MCP Server for nslookup.io
DNS lookups, SSL certificate checks, security scanning, GEO (AI readiness) scoring, domain intelligence, and your own monitoring account — via the Model Context Protocol.
Website · API Docs · npm · Contact
这是什么?
nslookup.io MCP服务器允许任何支持MCP的AI助手(Claude、ChatGPT、Cursor、Windsurf等)直接访问nslookup.io的DNS、证书、安全和监控工具。用通俗易懂的语言提问-- “在github上运行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 |
| 传输 | 流式HTTP(远程) | stdio(在您的计算机上运行) |
| 安装 | 无需安装 | 需要Node.js 18+ |
| 17个公共工具✅ 匿名 | ✅ 匿名 | |
6 my_ 帐户工具 |
✅ 浏览器登录(OAuth) 首次使用时❌ 本地不可用--使用托管连接器 |
如果您想要自己的监控数据,请使用托管端点 --这是唯一一种 my_ 帐户工具直接在浏览器中为您登录。本地模式非常适合17个无需设置的公共工具。
连接您的帐户(门户)工具
使用 您自己的NsLookup.io监控数据 (6 my_ 帐户工具),添加 托管连接器 并登录。 没有API密钥 --身份验证是针对您的nslookup.io帐户的一次性浏览器登录(OAuth)。
克劳德代码(CLI)
claude mcp add --transport http nslookup https://mcp.nslookup.io/mcp
然后调用一个帐户工具——例如ask _“显示我的监控概述”_出现浏览器登录窗口;登录一次后,全部6个 my_ 工具起作用(客户会记住它)。
克劳德桌面/Claude.ai --添加带有URL的自定义连接器 https://mcp.nslookup.io/mcp,然后在提示时登录。
.mcp.json (项目)或任何支持HTTP的客户端:
{ "mcpServers": { "nslookup": { "type": "http", "url": "https://mcp.nslookup.io/mcp" } } }
这17个公共工具可以立即在同一个端点上工作——你只有在第一次访问自己的数据时才能登录。
托管(推荐)
托管端点是一个远程可流式HTTP服务器。公共工具立即工作;你第一次打电话给 my_ 工具中,支持OAuth的客户端会打开一个浏览器窗口登录到您的nslookup.io帐户(请参阅 签到).
克劳德代码(CLI)
claude mcp add --transport http nslookup https://mcp.nslookup.io/mcp
Claude桌面/Claude.ai(自定义连接器)
- 打开 设置→ 连接器
- 点击 添加自定义连接器
- 姓名:
nslookup--网址:https://mcp.nslookup.io/mcp - 点击 添加
或者将其放入 .mcp.json (项目)/客户的MCP配置:
{
"mcpServers": {
"nslookup": {
"type": "http",
"url": "https://mcp.nslookup.io/mcp"
}
}
}
ChatGPT
- 打开 设置→ 已连接的应用程序 (或 工具和集成)
- 点击 添加自定义集成 / 添加MCP服务器
- 姓名:
nslookup--网址:https://mcp.nslookup.io/mcp - 保存
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_ 账户工具),使用 托管连接器 登录-本地传输上没有帐户工具。
克劳德代码(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 桌面版 --添加到 claude_desktop_config.json:
{
"mcpServers": {
"nslookup": {
"command": "npx",
"args": ["-y", "@nslookup-io/mcp-server"]
}
}
}
光标 (.cursor/mcp.json) / 帆板运动 (~/.codeium/windsurf/mcp_config.json):
{
"mcpServers": {
"nslookup": {
"command": "npx",
"args": ["-y", "@nslookup-io/mcp-server"]
}
}
}
⚠️ 仅使用一个nslookup条目
配置 要么 托管条目 或 本地入口——不是两者都有。如果两个MCP服务器命名 nslookup 如果一次注册(例如托管连接器加上本地npx条目),工具调用可能会路由到错误的服务器,并且行为不可预测。选择您想要的模式并删除另一个。
签到
- 17公共工具 --没有账号,没有钥匙,没什么可登录的。它们称之为公共、无状态、无身份验证端点。
- 6
my_账户工具 --读取您的私人监控数据,因此需要登录:- 托管端点→ 浏览器OAuth。 服务器是OAuth 2.1资源服务器。呼叫a
my_没有凭据的工具返回401带着一个WWW-Authenticate然后引导您通过浏览器登录nslookup.io身份提供程序(Keycloak)。 没有API密钥 --登录一次,客户端就会记住它。其他一切都是匿名的——你只有在第一次访问自己的数据时才能登录。看 连接您的帐户(门户)工具.
- 托管端点→ 浏览器OAuth。 服务器是OAuth 2.1资源服务器。呼叫a
工具参考
公共工具(17-匿名)
域名系统
| 工具 | 说明 |
|---|---|
dns_lookup |
查找域的所有常见DNS记录(A、AAAA、NS、MX、TXT、CNAME、SOA) |
dns_record |
查找特定的DNS记录类型——支持所有53种类型(HTTPS、DNSKEY、TLSA、SPF等) |
dns_propagation |
检查18台以上全球服务器(Cloudflare、Google、Quad9、区域性、权威性)上的DNS传播 |
webservers |
获取域的IPv4和IPv6地址 |
dns_change_review |
在应用之前审查拟议的DNS更改:与当前DNS的差异、基于规则的修复结果以及0-100的风险评分 |
领域情报
| 工具 | 说明 |
|---|---|
rdap_lookup |
IP、AS号码或域的注册数据(RDAP)——所有者组织、网络范围、RIR、联系人、日期 |
hosting_report |
谁托管网站:托管提供商、CDN/代理、DNS提供商、邮件服务器、服务器位置、SSL颁发者 |
status_page |
读取公共状态页面(按slug或自定义域):总体状态、组件、活动事件 |
DNS健康与安全
| 工具 | 说明 |
|---|---|
dns_health |
运行DNS健康审计(对DNSSEC、MX、卫生、TTL、名称服务器、CAA、操作成熟度进行39次检查),并进行严重性加权评分 |
ssl_certificate |
检查SSL/TLS证书——颁发者、到期时间、链有效性、密码强度、SAN域、TLS版本 |
bimi_vmc |
检查BIMI记录和VMC(验证标记证书)——徽标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(人工智能就绪)
| 工具 | 说明 |
|---|---|
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 |
(请求派生) | (HTTP服务器)此资源服务器的显式公共源,用作 issuer/resource/authorization_servers OAuth元数据中的值。未设置时,源代码来自传入的请求(X-Forwarded-Proto +主机)。将其设置为固定的公共URL(例如。 https://mcp.nslookup.io)在生产中。 |
KEYCLOAK_ISSUER |
https://auth.nslookup.io/realms/nslookup-io |
(HTTP服务器)OAuth令牌颁发者,用于验证登录JWT(JWKS、颁发者、exp) |
KEYCLOAK_REALM_URL |
(= KEYCLOAK_ISSUER) |
(HTTP服务器)Keycloak领域基础URL,其 /.well-known/openid-configuration 供应真实 authorization_endpoint/token_endpoint。对于Keycloak,这等于发卡机构,因此很少需要设置。 |
KEYCLOAK_CLIENT_ID |
nslookup-io-mcp |
(HTTP服务器)预注册 公共 DCR垫片返回的Keycloak客户端id。此客户端必须已存在于域中;未启用Keycloak DCR。 |
How hosted OAuth sign-in works under the hood
托管服务器是OAuth 2.1 资源服务器:呼叫a my_ 没有凭据的工具返回 401 带着一个 WWW-Authenticate 挑战指向 /.well-known/oauth-protected-resource,然后,支持OAuth的MCP客户端会引导您登录nslookup.io身份提供程序。
登录仅适用于DCR客户端(克劳德网络/桌面、克劳德代码) 没有 启用Keycloak DCR。服务器还充当自己的OAuth 授权服务器 对于元数据: GET /.well-known/oauth-authorization-server 返回a issuer 等于此服务器自己的源 authorization_endpoint/token_endpoint 指向 真正的钥匙斗篷 端点(从域的OpenID配置中获取,用静态回退缓存)和 registration_endpoint 着手 <origin>/register因为广告 issuer 这是计算的服务器和客户端吗 {issuer}/register 打我们的 动态客户端注册(DCR)垫片 在 POST /register (也 POST /oauth/register),忽略提交的元数据并返回一个 预先注册的公共Keycloak客户端 (KEYCLOAK_CLIENT_ID,默认值 nslookup-io-mcp)与 token_endpoint_auth_method: "none",回显请求的重定向URI。浏览器登录和PKCE code→令牌交换直接在Keycloak上进行。一个公共客户 KEYCLOAK_CLIENT_ID 必须已经存在于该领域;未使用或暴露Keycloak DCR端点。
示例提示
连接后,尝试询问您的AI助手:
- “github的DNS记录是什么?”
- “检查google.com的MX记录”
- “DNS是否传播了my-domain.com的A记录?”
- “cloudflare.com解析到哪些IP地址?”
- “显示DNSKEY记录,例如.com”
- “检查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”
- “检查所有全局服务器上example.com NS记录的DNS传播”
- “查看github.com的GEO得分”
- “example.com是否针对人工智能搜索引擎进行了优化?”
- “cloudflare.com会屏蔽哪些AI爬虫?”
- “谁拥有知识产权8.8.8.8?”
- “查找AS13335的注册数据”
- “谁托管github?”
- “在应用之前,请先查看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