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 开发: 完整的类型安全和现代化架构

🚀 快速部署

一键部署

命令行部署

本地开发

🔧 MCP 工具

1. dns_lookup

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

示例用法:

• 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 服务器的详细调试信息，用于故障排查。

示例用法:

• 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 设置中添加配置：

其他 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

DNS 调试 API

🏗️ 架构特点

智能共识算法

• 并行查询多个 DoH 服务器

• 统计答案一致性

• 选择共识度最高的结果

• 优选响应时间最快的服务器

容错机制

• 500ms 默认超时保护

• 自动跳过失败的服务器

• 详细的错误信息记录

• 优雅的降级处理

现代化开发

• TypeScript 完整类型支持

• Biome 代码格式化和检查

• Cloudflare Workers 边缘计算

• 标准 MCP 协议实现

🔧 配置选项

超时时间建议

• 快速查询: 100-500ms

• 标准查询: 500-1000ms

• 调试模式: 2000-5000ms

• 网络不佳: 5000-10000ms

性能优化

• 使用较短超时时间提高响应速度

• 调试模式使用较长超时获取完整信息

• 根据网络环境调整超时参数

📝 开发说明

项目结构

添加新的 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 规范

• 项目仓库