Name: WHOIS查询工具服务器
Author: WhoisFreaks

使用说明

WhoisFreaks MCP服务器

A. 模型上下文协议（MCP） 公开完整信息的服务器 谁是怪胎API 套件作为AI可调用工具。适用于Claude Desktop、Cursor、Windsurf、VS Code、Continue、Zed和任何其他兼容MCP的AI客户端。

运行它的两种方法——选择适合您设置的方法：

	方法	要求	最适合
⭐ 推荐	Docker（预构建映像）	仅限Docker	每个人——不需要Java或Maven
	从源代码构建	Java 17+Maven	贡献者/自定义构建

运行后，通过以下方式将其连接到任何MCP客户端标准（本地）或 端口3100上的HTTP/SSE （远程VM）。

工具参考

WHOIS工具

工具	说明
`liveWhoisLookup`	任何域名的实时WHOIS数据——注册商、注册人、日期、名称服务器
`whoisHistory`	域的完整所有权历史时间线
`reverseWhoisLookup`	查找按电子邮件地址、关键字、所有者姓名或公司注册的所有域

IP和ASN WHOIS工具

工具	说明
`ipWhoisLookup`	任何IPv4或IPv6地址的WHOIS注册数据
`asnWhoisLookup`	自治系统编号的WHOIS数据（例如AS15169）

DNS工具

工具	说明
`dnsLookup`	实时DNS记录——A、AAAA、MX、NS、CNAME、SOA、TXT、SPF或全部
`dnsHistory`	具有完整更改时间线的历史DNS记录
`reverseDnsLookup`	查找指向给定IP或名称服务器的所有域

IP智能工具

工具	说明
`ipGeolocation`	任何IP地址的国家、城市、地区、ISP和坐标
`ipSecurity`	VPN、代理、Tor出口节点、机器人和任何IP的威胁情报

域名工具

工具	说明
`domainAvailability`	检查域名是否可以注册，并提供可选建议
`subdomainLookup`	使用状态和日期筛选器枚举域的所有已知子域
`domainDiscovery`	按关键字查找域名，包括拼写和类似变体

SSL工具

工具	说明
`sslLookup`	SSL/TLS证书详细信息——颁发者、到期时间、SAN、链和原始输出

快速开始

⭐ 推荐——Docker

不需要Java或Maven。直接从Docker Hub中提取预构建映像并运行。

首先获取免费的API密钥： whoisbreaks.com/注册

选项1——直接 `docker run` （最简单）

docker run -d \
  --name whoisfreaks-mcp \
  --restart unless-stopped \
  -p 3100:3100 \
  -e WHOISFREAKS_API_KEY=your-api-key-here \
  whoisfreaks/mcp-server:latest

MCP网关现已上线 http://localhost:3100/sse.

选项2-Docker Compose（建议用于生产/VM）

创建一个 docker-compose.yml:

services:
  whoisfreaks-mcp:
    image: whoisfreaks/mcp-server:latest
    container_name: whoisfreaks-mcp
    restart: unless-stopped
    ports:
      - "3100:3100"
    environment:
      WHOISFREAKS_API_KEY: your-api-key-here

启动它：

docker compose up -d

或者使用 .env 文件而不是硬编码密钥（推荐）：

# Create .env file (never commit this to git)
echo "WHOISFREAKS_API_KEY=your-api-key-here" > .env
docker compose up -d

验证Docker是否正常工作

# Container should show as "Up"
docker ps

# SSE endpoint should respond
curl http://localhost:3100/health
# → {"status":"ok"}

# List all 14 registered tools
curl http://localhost:3100/tools/list

与Claude Desktop配合使用（Docker stdio模式）

Claude Desktop需要stdio传输。覆盖Docker入口点以绕过 mcp-proxy 并直接运行JAR：

{
  "mcpServers": {
    "whoisfreaks": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "WHOISFREAKS_API_KEY=your-api-key-here",
        "--entrypoint", "java",
        "whoisfreaks/mcp-server:latest",
        "-jar", "app.jar"
      ]
    }
  }
}

这里不需要端口映射——Claude Desktop直接通过stdio与容器通信。

从源代码构建

仅当您想修改代码或构建自定义版本时才需要。

先决条件：

要求	最低版本	注意事项
Java（JDK）	17	请与 `java -version`
Maven	3.8	检查 `mvn -version`
WhoisFreaks API密钥	-	获取您的密钥 whoisbreaks.com/注册

克隆和构建：

git clone https://github.com/whoisfreaks/whoisfreaks-mcp-server.git
cd whoisfreaks-mcp-server
mvn clean package -q

这将生成一个独立的脂肪JAR：

target/whoisfreaks-mcp-server-1.0.0.jar

提示： 注意 绝对路径 对于这个JAR，您将在下面的平台配置中需要它。例子： /Users/yourname/whoisfreaks-mcp-server/target/whoisfreaks-mcp-server-1.0.0.jar

先决条件

要求	注意事项
Docker	推荐的Docker路径需要
Java 17+Maven 3.8	仅当从源代码构建时才需要
WhoisFreaks API密钥	免费 whoisbreaks.com/注册

平台集成

1.克劳德桌面

最受欢迎的MCP客户端。Claude Desktop在启动时将MCP服务器作为子进程启动，并通过以下方式进行通信标准 --它不支持SSE/HTTP URL。

配置文件位置：

操作系统	路径
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
窗户	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

⭐ 选项A——Docker（推荐，不需要Java）

{
  "mcpServers": {
    "whoisfreaks": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "WHOISFREAKS_API_KEY=your-api-key-here",
        "--entrypoint", "java",
        "whoisfreaks/mcp-server:latest",
        "-jar", "app.jar"
      ]
    }
  }
}

打开Claude Desktop之前，Docker必须正在运行。首次使用时会自动提取图像。

选项B——直接JAR（需要Java 17）

{
  "mcpServers": {
    "whoisfreaks": {
      "command": "java",
      "args": ["-jar", "/absolute/path/to/whoisfreaks-mcp-server-1.0.0.jar"],
      "env": {
        "WHOISFREAKS_API_KEY": "your-api-key-here"
      }
    }
  }
}

步骤（两个选项）：

将上面的配置粘贴到配置文件中（如果不存在，则创建它）
保存文件
完全退出克劳德桌面(Cmd+Q 在Windows上的macOS/任务栏退出）
重新打开克劳德桌面
点击 锤图标 聊天输入中的（工具）-您应该看到列出了14个WhoisFreaks工具

验证它是否有效： 类型 Who owns google.com? 克劳德会自动打电话 liveWhoisLookup.

2.光标IDE

Cursor支持stdio和SSE传输。配置文件： ~/.cursor/mcp.json

⭐ 选项A——通过SSE使用Docker（推荐）

{
  "mcpServers": {
    "whoisfreaks": {
      "url": "http://localhost:3100/sse",
      "transport": "sse"
    }
  }
}

首先启动Docker容器： docker run -d -p 3100:3100 -e WHOISFREAKS_API_KEY=your-key whoisfreaks/mcp-server:latest

选项B——通过stdio使用Docker（无需端口）

{
  "mcpServers": {
    "whoisfreaks": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "WHOISFREAKS_API_KEY=your-api-key-here",
        "--entrypoint", "java",
        "whoisfreaks/mcp-server:latest",
        "-jar", "app.jar"
      ]
    }
  }
}

选项C-JAR直接（需要Java 17）

{
  "mcpServers": {
    "whoisfreaks": {
      "command": "java",
      "args": ["-jar", "/absolute/path/to/whoisfreaks-mcp-server-1.0.0.jar"],
      "env": {
        "WHOISFREAKS_API_KEY": "your-api-key-here"
      }
    }
  }
}

步骤：

保存 ~/.cursor/mcp.json 根据您选择的选项
重新启动游标
打开 AI面板 (Cmd+L) → 您应该看到一个工具指示器，显示WhoisFreaks工具
问： Check the SSL certificate for github.com

3.风帆IDE

Windsurf（由Codeium提供）通过其Cascade AI侧边栏支持MCP。

配置文件位置：

操作系统	路径
macOS	`~/.codeium/windsurf/mcp_config.json`
窗户	`%USERPROFILE%\.codeium\windsurf\mcp_config.json`
Linux	`~/.codeium/windsurf/mcp_config.json`

⭐ 选项A——通过stdio使用Docker（推荐）

{
  "mcpServers": {
    "whoisfreaks": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "WHOISFREAKS_API_KEY=your-api-key-here",
        "--entrypoint", "java",
        "whoisfreaks/mcp-server:latest",
        "-jar", "app.jar"
      ]
    }
  }
}

选项B——直接JAR（需要Java 17）

{
  "mcpServers": {
    "whoisfreaks": {
      "command": "java",
      "args": ["-jar", "/absolute/path/to/whoisfreaks-mcp-server-1.0.0.jar"],
      "env": {
        "WHOISFREAKS_API_KEY": "your-api-key-here"
      }
    }
  }
}

步骤：

使用您选择的选项保存配置
重新启动Windsurf
打开Cascade侧边栏→ 查找MCP工具指示灯（插头图标）
问： Find all subdomains of tesla.com

注：风浪需要Cascade进入写工具使用模式。如果未调用工具，请从Cascade标头中切换它。

4.VS代码+GitHub副本

VS Code通过GitHub Copilot扩展（聊天参与者/工具功能）支持MCP工具。

配置文件 (.vscode/mcp.json 在您的工作空间中，或 ~/.vscode/mcp.json 全球）：

⭐ 选项A——通过SSE使用Docker（推荐，容器必须正在运行）

{
  "servers": {
    "whoisfreaks": {
      "type": "sse",
      "url": "http://localhost:3100/sse"
    }
  }
}

先启动容器： docker run -d -p 3100:3100 -e WHOISFREAKS_API_KEY=your-key whoisfreaks/mcp-server:latest

选项B——通过stdio使用Docker

{
  "servers": {
    "whoisfreaks": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "WHOISFREAKS_API_KEY=your-api-key-here",
        "--entrypoint", "java",
        "whoisfreaks/mcp-server:latest",
        "-jar", "app.jar"
      ]
    }
  }
}

选项C-JAR直接（需要Java 17）

{
  "servers": {
    "whoisfreaks": {
      "type": "stdio",
      "command": "java",
      "args": ["-jar", "/absolute/path/to/whoisfreaks-mcp-server-1.0.0.jar"],
      "env": {
        "WHOISFREAKS_API_KEY": "your-api-key-here"
      }
    }
  }
}

步骤：

确保你有 GitHub Copilot 聊天助手 已安装扩展（v1.99+）
使用您选择的选项保存上面的配置文件
打开Copilot聊天(Ctrl+Shift+I / Cmd+Shift+I)
将模型切换到 代理模式 使用下拉菜单
点击工具按钮——WhoisFreaks工具应出现在列表中
问： What are the MX records for github.com?

要求： MCP工具支持需要VS Code 1.99+和GitHub Copilot Chat扩展。

5.继续开发

Continue是一个开源的AI编码助手，支持VS Code和JetBrains IDE的MCP。

配置文件 (~/.continue/config.json):

⭐ 选项A——通过SSE使用Docker（推荐，容器必须正在运行）

{
  "mcpServers": [
    {
      "name": "whoisfreaks",
      "url": "http://localhost:3100/sse",
      "transport": "sse"
    }
  ]
}

先启动容器： docker run -d -p 3100:3100 -e WHOISFREAKS_API_KEY=your-key whoisfreaks/mcp-server:latest

选项B——通过stdio使用Docker

{
  "mcpServers": [
    {
      "name": "whoisfreaks",
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "WHOISFREAKS_API_KEY=your-api-key-here",
        "--entrypoint", "java",
        "whoisfreaks/mcp-server:latest",
        "-jar", "app.jar"
      ]
    }
  ]
}

选项C-JAR直接（需要Java 17）

{
  "mcpServers": [
    {
      "name": "whoisfreaks",
      "command": "java",
      "args": ["-jar", "/absolute/path/to/whoisfreaks-mcp-server-1.0.0.jar"],
      "env": {
        "WHOISFREAKS_API_KEY": "your-api-key-here"
      }
    }
  ]
}

步骤：

安装继续来自VS代码市场或JetBrains插件市场的扩展
编辑 ~/.continue/config.json 根据您选择的选项
重新加载窗口(Cmd+Shift+P → Reload Window)
打开继续侧栏——WhoisFreaks的工具将在聊天中可用
问： Look up IP geolocation for 1.1.1.1

6.Zed编辑

Zed有一个内置的AI助手，通过其MCP支持 assistant 配置。

配置文件 (~/.config/zed/settings.json):

⭐ 选项A——通过stdio使用Docker（推荐）

{
  "assistant": {
    "mcp_servers": {
      "whoisfreaks": {
        "command": "docker",
        "args": [
          "run", "-i", "--rm",
          "-e", "WHOISFREAKS_API_KEY=your-api-key-here",
          "--entrypoint", "java",
          "whoisfreaks/mcp-server:latest",
          "-jar", "app.jar"
        ]
      }
    }
  }
}

选项B——直接JAR（需要Java 17）

{
  "assistant": {
    "mcp_servers": {
      "whoisfreaks": {
        "command": "java",
        "args": ["-jar", "/absolute/path/to/whoisfreaks-mcp-server-1.0.0.jar"],
        "env": {
          "WHOISFREAKS_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}

步骤：

打开Zed→ Zed menu → Settings （或 Cmd+,)
添加 mcp_servers 使用所选选项阻止现有设置JSON
保存并重新启动Zed
打开AI面板(Cmd+?) → 工具将列在工具指示器下
问： Is the domain myapp.io available?

示例提示

在上述任何客户端中配置后，请尝试以下提示：

# WHOIS
Who owns the domain apple.com? Give me full WHOIS details.
Show me the complete ownership history for whoisfreaks.com.
Find all domains registered by admin@google.com.

# IP & ASN WHOIS
What organization owns the IP address 8.8.8.8?
Look up ASN information for AS15169.

# DNS
What are the MX and NS records for github.com?
Has facebook.com changed its IP addresses in the last 2 years? (DNS history)
Which domains are pointing to the IP 104.21.0.0? (reverse DNS)

# IP Intelligence
Where is 1.1.1.1 located? What ISP runs it?
Is 185.220.101.45 a Tor exit node or a VPN?

# Domain Tools
Is mycompany.io available to register? Suggest 5 alternatives.
List all known subdomains of tesla.com.
Find domains similar to 'google' — possible typosquatting targets.

# SSL
Check the SSL certificate for github.com — who issued it and when does it expire?

环境变量

变量	必填	描述
`WHOISFREAKS_API_KEY`	是	您的API密钥来自 whoisbreaks.com/billing.所有14个工具调用 `api.whoisfreaks.com` 直接使用此键——不需要其他变量。

故障排除

API错误

问题	原因	修复
`WHOISFREAKS_API_KEY is not set`	缺少环境变量	添加 `-e WHOISFREAKS_API_KEY=your-key` 添加到Docker命令中，或将其添加到 `env` 在客户端配置中阻止
`Unauthorized (HTTP 401/403)`	无效或无效的API密钥	请在whoisfreaks.com/billing上验证密钥
`No data found (HTTP 404)`	域/IP/ASN不在数据库中	仔细检查输入值是否正确
`Rate limit reached (HTTP 429)`	请求太多	减慢或升级您的计划
`Credit limit exceeded (HTTP 413)`	积分用尽	在whoisbreaks.com/billing添加积分
`Timeout (HTTP 408)`	上游WHOIS服务器速度较慢	重试-某些顶级域名的WHOIS伺服器速度较慢

Docker错误

问题	原因	修复
`Cannot connect to Docker daemon`	Docker Desktop未运行	打开Docker Desktop并等待引擎启动
容器立即退出	缺少API键或错误的入口点	检查日志： `docker logs whoisfreaks-mcp`
`port 3100 already in use`	端口3100上的另一个进程	停止它： `docker rm -f whoisfreaks-mcp` 然后重试
`no such image`	图像尚未提取	运行 `docker pull whoisfreaks/mcp-server:latest` 首先
Claude Desktop：工具未随Docker配置一起出现	应用程序未看到Docker在PATH中	使用完整的Docker路径： `/usr/local/bin/docker` 随着 `command`
`lstat deploy: no such file or directory` （CI/CD）	GitHub操作中的相对路径问题	使用 `${{ github.workspace }}/deploy/Dockerfile` 对于绝对路径
网关 `connection refused` 在端口3100上	容器未运行或端口未映射	运行 `docker ps` --确保 `-p 3100:3100` 位于run命令中
几秒钟后SSE连接中断	Nginx代理超时	添加 `proxy_read_timeout 3600s;` 到您的Nginx位置块

客户端错误

问题	原因	修复
工具在客户端不可见	配置未保存或客户端未重新启动	保存配置→ 完全退出并重新打开客户端
`UnsupportedClassVersionError` （JAR模式）	Java版本太旧	升级到Java 17+(`java -version` 检查）
JAR路径错误	配置中的相对路径	使用JAR的完整绝对路径
光标显示工具但不调用它们	未启用代理模式	将光标切换到代理模式，非聊天模式
Claude Desktop跳过whoisbreaks条目	使用SSE URL代替stdio	Claude Desktop需要 `command`/`args` --不是 `url`.使用上面显示的Docker stdio配置
未调用Windsurf工具	级联模式错误	将级联切换到写模式来自Cascade标头

链接

WhoisFreaks API文档： https://whoisfreaks.com/documentation
API密钥和计费： https://whoisfreaks.com/billing
MCP协议规范： https://modelcontextprotocol.io
MCP检验员（测试工具）： npx @modelcontextprotocol/inspector
问题与支持： 在GitHub上打开一个问题

使用说明

WhoisFreaks MCP服务器

目录

工具参考

WHOIS工具

IP和ASN WHOIS工具

DNS工具

IP智能工具

域名工具

SSL工具

快速开始

⭐ 推荐——Docker

选项1——直接 docker run （最简单）

选项2-Docker Compose（建议用于生产/VM）

验证Docker是否正常工作

与Claude Desktop配合使用（Docker stdio模式）

从源代码构建

先决条件

平台集成

1.克劳德桌面

2.光标IDE

3.风帆IDE

4.VS代码+GitHub副本

5.继续开发

6.Zed编辑

示例提示

环境变量

故障排除

API错误

Docker错误

客户端错误

链接

相关 MCP

IP情报查询工具

DNS查询服务

百度AI搜索

实时网络搜索服务

12306票务搜索服务

arXiv 论文检索 MCP 服务器

选项1——直接 `docker run` （最简单）