内容
# DechoNet MCP 服务器
用于 AI 代理的域名安全侦察工具,基于 [模型上下文协议](https://modelcontextprotocol.io)。
13 种安全工具 — DNS、SSL、HTTP 头部、电子邮件身份验证、端口扫描、传播、反向 DNS、ASN/BGP、RDAP/WHOIS、子网计算和综合安全扫描 — 可从 Claude Desktop 和任何兼容 MCP 的 AI 代理调用。
**DechoNet 组成部分。** 这里的每个工具也是 [dechonet.com](https://dechonet.com) 上的免费网络工具 — 无需注册,无需 API 密钥 — 并由错误修复指南支持。该软件包将相同的检查带到 AI 代理。
## 快速开始(Claude Desktop)
将以下内容添加到 `claude_desktop_config.json`:
```json
{
"mcpServers": {
"dechonet": {
"command": "npx",
"args": ["-y", "dechonet-mcp"]
}
}
}
```
或者,如果已本地安装:
```json
{
"mcpServers": {
"dechonet": {
"command": "node",
"args": ["/path/to/dechonet/mcp/build/index.js"]
}
}
}
```
配置文件位置:
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
重启 Claude Desktop。你将在输入区域看到 DechoNet 工具图标。
## 安装
```bash
# 通过 npx(无需安装)
npx dechonet-mcp
# 或全局安装
npm install -g dechonet-mcp
```
## 可用工具
| 工具 | 描述 |
|------|-------------|
| `security_scan` | **综合扫描** — 9 项检查并行,0-100 健康评分,A-F 等级 |
| `dns_lookup` | DNS 记录 + DNSSEC + SPF/DMARC 验证 |
| `ssl_check` | SSL/TLS 证书、链、TLS 版本、A-F 等级 |
| `http_security` | HTTP 重定向跟踪 + 10 个安全头部审计,A-F 等级 |
| `email_auth` | SPF、DMARC、DKIM、BIMI、MTA-STS、DANE + 黑名单检查 |
| `port_scan` | 开放的 TCP 端口,带有服务识别 |
| `dns_propagation` | DNS 传播,跨越 8+ 个全球解析器 |
| `reverse_dns` | PTR 记录 + FCrDNS 验证 |
| `asn_lookup` | ASN/BGP 网络识别 + 滥用联系方式 |
| `whois_lookup` | RDAP/WHOIS 域名注册数据 |
| `ip_info` | 公共 IP、ISP、ASN、代理检测 |
| `email_header_analysis` | 电子邮件投递路由跟踪 + 身份验证结果 |
| `subnet_calc` | CIDR 子网计算器(离线) |
## 示例提示
连接后,尝试询问 Claude:
- "检查 example.com 的安全状况"
- "mysite.com 的 SSL 证书是否即将过期?"
- "example.com 有哪些 DNS 记录?"
- "扫描 my-server.com 的开放端口"
- "分析这些电子邮件头部:[粘贴头部]"
- "8.8.8.8 的 ASN 是什么?"
- "计算 10.0.0.0/16 的子网"
## SSE 传输(远程)
对于远程/基于 HTTP 的 MCP 连接:
```bash
cd mcp
npm run start:sse
# 服务器运行于 http://localhost:3100
# SSE 端点:http://localhost:3100/sse
```
## 开发
```bash
cd mcp
npm install
npm run build # TypeScript → build/
npm run dev # 运行 tsx(stdio)
npm run start:sse # 运行 SSE 服务器
```
## 工作原理
MCP 服务器调用 DechoNet 的公共 API (`https://dechonet.com/api/util/*`) — 与 [dechonet.com](https://dechonet.com) 网络工具相同的后端 — 并返回结构化结果,包含:
- **状态**(ok/warn/bad)
- **KPI**(每个工具的关键绩效指标)
- **问题**,具有严重性(critical/warning/info)和置信度
- **可行的补救步骤**
- **原始数据**(完整 JSON)
所有数据均来自公共来源(DNS、HTTP 头部、SSL 证书、RDAP)。无主动利用。
## 环境变量
| 变量 | 默认值 | 描述 |
|----------|---------|-------------|
| `DECHONET_URL` | `https://dechonet.com` | API 基地址 |
| `DECHONET_LOCALE` | `en` | 响应语言(`en` 或 `ko`) |
| `PORT` | `3100` | SSE 服务器端口 |
## 关于 DechoNet
[DechoNet](https://dechonet.com) 是一个域名安全侦察平台 — 分布式观察,交叉验证。同样的诊断以三种方式提供:免费网络工具、错误修复指南和此 MCP 服务器。
- 🌐 **网络工具**(免费,无需注册):https://dechonet.com
- 📘 **指南**(修复常见的 DNS/SSL/HTTP/电子邮件错误):https://dechonet.com/guides
- 🐦 **X**: https://x.com/Dechonetwork
MIT 许可。欢迎提出问题和合并请求。