内容
# DomScan MCP 服务器
> 为 AI 代理提供域名情报。连接 [DomScan](https://domscan.net) 到 Claude、Cursor、VS Code 和任何 [模型上下文协议](https://modelcontextprotocol.io/) 客户端，以直接从您的助手运行 DNS、WHOIS/RDAP、SSL/TLS、子域名、可用性、估值、电子邮件安全和品牌保护查询。
DomScan 是一个域名情报平台，通过一个 REST API 和一个托管的 MCP 服务器提供其数据。该仓库记录了 MCP 服务器：如何连接它、它提供了哪些工具，以及如何在代理管道中使用它。
- 网站：https://domscan.net
- MCP 端点：`https://domscan.net/mcp`（可流式传输的 HTTP）
- 传输：可流式传输的 HTTP（远程）
- 认证：OAuth 发现（推荐）或 DomScan API 密钥
## 快速入门
### 支持 OAuth 的客户端
添加 `https://domscan.net/mcp` 作为远程 MCP 服务器。DomScan 发布 OAuth 保护资源和授权服务器元数据，因此兼容的客户端可以在无需手动配置 API 密钥的情况下发现并完成身份验证。
```json
{
"mcpServers": {
"domscan": {
"url": "https://domscan.net/mcp"
}
}
}
```
### Claude Desktop / Claude Code 使用 API 密钥
在您的 MCP 配置文件（`claude_desktop_config.json` 或 `.mcp.json`）中添加：
```json
{
"mcpServers": {
"domscan": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://domscan.net/mcp",
"--header",
"Authorization: Bearer ${DOMSCAN_API_KEY}"
],
"env": { "DOMSCAN_API_KEY": "your-api-key" }
}
}
}
```
### 原生远程 URL 使用 API 密钥
```json
{
"mcpServers": {
"domscan": {
"url": "https://domscan.net/mcp",
"headers": { "Authorization": "Bearer your-api-key" }
}
}
}
```
从 [DomScan 控制面板](https://domscan.net/dashboard) 获取 API 密钥。如果客户端支持，推荐使用 OAuth。API 密钥仍然可用于需要显式头部身份验证的客户端。
## 本地 MCP 包装器
该仓库包含一个可运行的标准输入/输出包装器，供无法直接连接到托管的可流式传输 HTTP 端点的客户端使用。它使用 `DOMSCAN_API_KEY` 将请求转发到 `https://domscan.net/mcp`。
```bash
npm install
DOMSCAN_API_KEY=your-api-key npm start
```
如果未配置 API 密钥，包装器仍会启动并仅公开只读的 `domscan_mcp_status` 工具。这允许 MCP 注册表在不授予域名情报操作访问权限的情况下检查和验证服务器。
### Docker
```bash
docker build -t domscan-mcp .
docker run --rm -i -e DOMSCAN_API_KEY=your-api-key domscan-mcp
```
本地包装器使用 API 密钥身份验证。支持远程可流式传输 HTTP 和 OAuth 的客户端应继续直接连接到 `https://domscan.net/mcp`；对于这些客户端，OAuth 仍然是推荐的选项。
## 功能
服务器在以下领域公开域名情报工具：
- **DNS**：记录查询（A、AAAA、MX、TXT、NS、CNAME、CAA）、完整记录转储、传播检查、DNS 安全。
- **WHOIS / RDAP**：注册数据、WHOIS 历史、反向 WHOIS、RDAP。
- **SSL/TLS**：证书审计、链检查、评级、到期检查、深度扫描、证书搜索。
- **子域名**：子域名枚举和发现。
- **可用性和估值**：域名可用性（单个和批量）、评估、名称建议。
- **电子邮件安全**：SPF、DKIM、DMARC 验证和 DNSSEC 状态。
- **品牌保护**：域名抢注检测、品牌监视和扫描。
- **基础设施**：IP 查询、托管检测、ASN、技术/栈检测、MAC 供应商查询。
参见 [DomScan API 文档](https://domscan.net/docs) 和 [MCP 设置指南](https://domscan.net/mcp-domain-checker)。
## 为什么是 MCP
MCP 允许 AI 助手直接调用 DomScan：询问“acme.io 是否可用，谁拥有类似域名？”代理运行可用性、WHOIS 和域名抢注工具，并在一次查询中回答。同一服务器为自动化工作流（监控、尽职调查、品牌保护）提供支持，无需自定义集成代码。
## 链接
- 产品：https://domscan.net
- API 文档：https://domscan.net/docs
- MCP 设置指南：https://domscan.net/mcp-domain-checker
- MCP 规范：https://modelcontextprotocol.io/
- 数据集和 API：https://domscan.net/tools
## 许可证
MIT。参见 [LICENSE](LICENSE)。
