JinDaGe - mcp-dnstwist MCP Details

article

README

🚀 DNStwist MCP 服务器

DNStwist MCP 服务器是一个为 dnstwist 打造的模型上下文协议 (MCP) 服务器。dnstwist 是一款强大的 DNS 模糊测试工具，可用于检测拼写欺骗、网络钓鱼和公司间谍活动。此服务器提供了分析域变体并识别潜在恶意域的工具，且能与 MCP 兼容的应用程序（如 Claude Desktop）无缝集成。

🚀 快速开始

安装 Docker

curl -fsSL https://get.docker.com | bash -s docker

启动 Docker 服务

sudo systemctl start docker
sudo systemctl enable docker

拉取 DNStwist 镜像

docker pull dnstwist/mcp-server

运行 DNStwist 服务器

docker run -it dnstwist/mcp-server

✨ 主要特性

支持多种 DNS 操作（查询、解析等）。
提供详细的日志记录和调试信息。
高效的并行处理能力，适合大规模测试。

📦 安装指南

Docker 检查

docker --version
docker ps

Docker 权限

确保当前用户有权限运行 Docker 命令。
在 Linux 上，将用户添加到 docker 组：

sudo usermod -aG docker $USER

💻 使用示例

基础用法

本服务器可直接通过 Docker 运行，以下是启动服务器的命令：

docker run -it dnstwist/mcp-server

📚 详细文档

DNStwist 服务器配置

# 示例配置文件
{
  "dns_servers": ["8.8.8.8", "1.1.1.1"],
  "log_level": "debug",
  "bind_address": "0.0.0.0",
  "bind_port": 53,
  "tcp_enabled": true
}

常见问题

Docker 启动失败

确保 Docker 安装正确且版本兼容。
检查系统日志中的 Docker 错误信息。

DNS 解析缓慢

优化 DNS 服务器配置。
减少并发请求数量。

性能瓶颈

增加内存或 CPU 资源。
使用更高效的 DNS 库。

⚠️ 注意事项

⚠️ 重要提示

Docker 未安装或未运行：请先安装 Docker 并启动 Docker 守护程序。

无法解析 dnstwist 输出：检查域是否有效且格式正确。

执行 dnstwist 失败：查看 Docker 日志并确保权限配置正确。

DNS 服务器无响应：验证 DNS 服务器的访问性，并尝试其他 DNS 服务器。

🤝 贡献指南

** Fork 仓库**
** 创建功能分支**（git checkout -b feature/amazing-feature）
** 提交更改**（git commit -m '添加 amazing 功能'）
** 推送到分支**（git push origin feature/amazing-feature）
** 提交拉取请求**

📄 许可证

本项目在 MIT License 下开源，详情请见 LICENSE 文件。

mcp-dnstwist