Randark-JMT/doh-mcp

DoH MCP Server

基于 Cloudflare Workers 的 DNS over HTTPS (DoH) 服务器，集成 Model Context Protocol (MCP) 支持，为 AI 模型提供 DNS 查询功能。

🌟 功能特性

• 并行 DNS 查询: 同时查询多个公共 DoH 服务器获取最快可靠的结果
• 智能共识算法: 自动选择最具共识性的 DNS 解析结果
• 完整 MCP 支持: 标准化的工具和资源接口
• Web 可视化界面: 美观的前端查询面板，支持实时调试
• 多种记录类型: 支持 A、AAAA、CNAME、MX、TXT、NS、PTR、SRV、SOA 记录
• 调试功能: 详细的多服务器响应分析
• REST API: 提供标准 HTTP API 接口
• 高性能: 基于 Cloudflare Workers 的边缘计算
• TypeScript 开发: 完整的类型安全和现代化架构

🚀 快速部署

一键部署

命令行部署

npm create cloudflare@latest -- my-doh-server --template=https://github.com/Randark-JMT/doh-mcp

本地开发

# 克隆项目
git clone https://github.com/Randark-JMT/doh-mcp.git
cd MCPs/doh-worker

# 安装依赖
npm install

# 本地开发
npm run dev

# 部署到生产环境
npm run deploy

🔧 MCP 工具

1. dns_lookup

执行域名的 DNS 查询，返回最佳结果。

{
  domain: string,        // 要查询的域名
  type?: DNSRecordType,  // DNS 记录类型 (默认: "A")
  timeout?: number       // 超时时间，毫秒 (默认: 500)
}

示例用法:

• dns_lookup({"domain": "google.com"})
• dns_lookup({"domain": "example.com", "type": "MX"})
• dns_lookup({"domain": "cloudflare.com", "type": "AAAA", "timeout": 1000})

2. dns_debug

获取多个 DoH 服务器的详细调试信息，用于故障排查。

{
  domain: string,        // 要调试的域名
  type?: DNSRecordType,  // DNS 记录类型 (默认: "A")
  timeout?: number       // 超时时间，毫秒 (默认: 2000)
}

示例用法:

• dns_debug({"domain": "problematic-domain.com"})
• dns_debug({"domain": "example.com", "type": "TXT", "timeout": 5000})

3. get_doh_servers

获取所有可用的 DoH 服务器列表。

{}  // 无需参数

4. dns_record_types

获取支持的 DNS 记录类型说明。

{}  // 无需参数

🌐 支持的 DoH 服务器

• DNSPod: https://doh.pub/dns-query
• Alidns: https://dns.alidns.com/dns-query
• 360: https://doh.360.cn
• Google: https://dns.google/dns-query
• Cloudflare: https://cloudflare-dns.com/dns-query
• Quad9: https://dns.quad9.net/dns-query
• DNS.SB: https://doh.dns.sb/dns-query
• OpenDNS: https://doh.opendns.com/dns-query
• AdGuard: https://dns.adguard-dns.com/dns-query

📊 支持的 DNS 记录类型

🔌 连接方式

Cloudflare AI Playground

1. 访问 https://playground.ai.cloudflare.com/
2. 输入您的 MCP 服务器 URL: your-doh-server.your-account.workers.dev/sse
3. 开始使用 DNS 查询工具！

Claude Desktop

在 Claude Desktop 设置中添加配置：

{
  "mcpServers": {
    "doh-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-doh-server.your-account.workers.dev/sse"
      ]
    }
  }
}

其他 MCP 客户端

支持标准 MCP 协议的任何客户端都可以连接：

• SSE 端点: /sse
• HTTP 端点: /mcp

🛠️ API 端点

Web 界面

• GET / - 主页面（Web 查询界面）
• GET /debug - 调试页面（同主页面）

MCP 协议端点

• POST /sse - MCP SSE 连接
• GET /sse - MCP SSE 初始化
• POST /mcp - MCP HTTP 协议

REST API 端点

• POST /api/dns/lookup - DNS 查询 API
• POST /api/dns/debug - DNS 调试 API

传统端点

• GET /dns-query - 传统 DoH 查询接口（兼容性）

REST API 使用示例

DNS 查询 API

curl -X POST https://your-worker.workers.dev/api/dns/lookup \
  -H "Content-Type: application/json" \
  -d '{"domain": "google.com", "type": "A", "timeout": 1000}'

DNS 调试 API

curl -X POST https://your-worker.workers.dev/api/dns/debug \
  -H "Content-Type: application/json" \
  -d '{"domain": "google.com", "type": "A", "timeout": 2000}'

🏗️ 架构特点

智能共识算法

• 并行查询多个 DoH 服务器
• 统计答案一致性
• 选择共识度最高的结果
• 优选响应时间最快的服务器

容错机制

• 500ms 默认超时保护
• 自动跳过失败的服务器
• 详细的错误信息记录
• 优雅的降级处理

现代化开发

• TypeScript 完整类型支持
• Biome 代码格式化和检查
• Cloudflare Workers 边缘计算
• 标准 MCP 协议实现

🔧 配置选项

超时时间建议

• 快速查询: 100-500ms
• 标准查询: 500-1000ms
• 调试模式: 2000-5000ms
• 网络不佳: 5000-10000ms

性能优化

• 使用较短超时时间提高响应速度
• 调试模式使用较长超时获取完整信息
• 根据网络环境调整超时参数

📝 开发说明

项目结构

doh-worker/
├── src/
│   └── index.ts              # 主要业务逻辑
├── package.json              # 项目依赖
├── wrangler.jsonc           # Cloudflare Workers 配置
├── tsconfig.json            # TypeScript 配置
├── biome.json              # 代码格式化配置
├── worker-configuration.d.ts # 类型定义
└── README.md               # 项目文档

添加新的 DNS 工具

1. 在 DoHMCP 类的 init() 方法中添加新工具
2. 使用 this.server.tool() 定义工具
3. 使用 Zod 定义参数验证schema
4. 实现异步处理函数

添加新的 DoH 服务器

1. 在 DOH_SERVERS 对象中添加新服务器
2. 确保服务器支持标准 DoH 协议
3. 测试服务器的可用性和响应时间

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

MIT License

🔗 相关链接

• Model Context Protocol 文档
• Cloudflare Workers 文档
• DNS over HTTPS 规范
• 项目仓库