Whoisfreaks

Name: Whoisfreaks
Author: WhoisFreaks

本地服务

github.com/WhoisFreaks开发工具05 周前更新

代码仓库

关于 Whoisfreaks

Whoisfreaks 将 WhoisFreaks API 套件提供为 MCP 工具，面向需要查询域名、DNS、IP 和 SSL 信息的 AI 客户端。项目支持 Docker 部署，也可从源码构建，并通过 stdio 或 HTTP/SSE 连接。

主要功能

01实时及历史 WHOIS 查询
02DNS 记录与历史查询
03IP、ASN 与地理位置查询
04IP 安全情报查询
05域名发现、可用性与子域名查询
06SSL/TLS 证书详情查询

适用场景

01查看域名注册信息和所有权历史
02检查 DNS 记录或定位反向 DNS 域名
03查询 IP 地理位置及 VPN、代理或威胁信息
04枚举子域名并检查 SSL 证书

MCP 相关

通过 stdio 或 HTTP/SSE 向 MCP 客户端提供 WhoisFreaks API 工具，可使用 Docker 镜像或从源码构建。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "whoisfreaks": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "WHOISFREAKS_API_KEY",
        "java"
      ],
      "env": {
        "WHOISFREAKS_API_KEY": "<WHOISFREAKS_API_KEY>"
      }
    }
  }
}

启动命令docker run -i --rm -e WHOISFREAKS_API_KEY java

需要配置的环境变量

WHOISFREAKS_API_KEY密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

ocijavastdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

WhoisFreaks MCP 服务

一个 模型上下文协议（MCP） 服务，将完整的 WhoisFreaks API 套件作为可由 AI 调用的工具提供。可与 Claude Desktop、Cursor、Windsurf、VS Code、Continue、Zed 以及任何其他兼容 MCP 的 AI 客户端配合使用。

两种运行方式——选择适合你设置的方式：

	方法	所需条件	适用对象
⭐ 推荐	Docker（预构建镜像）	仅需 Docker	所有人——无需 Java 或 Maven
	从源代码构建	Java 17 + Maven	贡献者 / 自定义构建

启动后，可通过 stdio（本地）或 端口 3100 上的 HTTP/SSE（远程 VM）将其连接到任何 MCP 客户端。

工具参考

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`	任意 IP 的 VPN、代理、Tor 出口节点、机器人和威胁情报

域名工具

工具	描述
`domainAvailability`	检查域名是否可注册，并可选择获取建议
`subdomainLookup`	枚举域名的所有已知子域名，并可按状态和日期筛选
`domainDiscovery`	按关键词查找域名，包括仿冒域名和相似变体

SSL 工具

工具	描述
`sslLookup`	SSL/TLS 证书详情——颁发者、到期时间、SAN、证书链和原始输出

快速开始

⭐ 推荐 — Docker

无需 Java 或 Maven。直接从 Docker Hub 拉取预构建镜像并运行。

请先获取免费的 API 密钥： whoisfreaks.com/signup

选项 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 Key	—	在 whoisfreaks.com/signup 获取

克隆并构建：

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

这会生成一个独立的单体 fat 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 Key	在 whoisfreaks.com/signup 免费获取

平台集成

1. Claude Desktop

最受欢迎的 MCP 客户端。Claude Desktop 在启动时会将 MCP 服务作为子进程启动，并通过 stdio 通信——它不支持 SSE/HTTP URL。

配置文件位置：

操作系统	路径
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%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"
      }
    }
  }
}

步骤（两种选项均适用）：

将上方配置粘贴到配置文件中（如果文件不存在，则创建该文件）
保存文件
完全退出 Claude Desktop（macOS 上按 Cmd+Q / Windows 上从任务栏退出）
重新打开 Claude Desktop
点击聊天输入框中的锤子图标（工具）——你应该会看到列出的 14 个 WhoisFreaks 工具

**验证是否正常：**输入 Who owns google.com?，Claude 会自动调用 liveWhoisLookup。

2. Cursor 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
重启 Cursor
打开 AI 面板（Cmd+L）→ 你应该会看到显示 WhoisFreaks 工具的工具指示器
提问：Check the SSL certificate for github.com

3. Windsurf IDE

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

配置文件位置：

操作系统	路径
macOS	`~/.codeium/windsurf/mcp_config.json`
Windows	`%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

注意： 使用工具时，Windsurf 要求 Cascade 处于 Write 模式。如果工具未被调用，请在 Cascade 标题栏中切换模式。

4. VS Code + GitHub Copilot

VS Code 通过 GitHub Copilot 扩展（Chat Participants / Tools 功能）支持 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 Chat 扩展（v1.99+）
使用你选择的选项，保存上方的配置文件
打开 Copilot Chat（Ctrl+Shift+I / Cmd+Shift+I）
使用下拉菜单将模型切换到 Agent 模式
点击 Tools 按钮 — 列表中应会显示 WhoisFreaks 工具
提问：What are the MX records for github.com?

要求： VS Code 1.99+ 和 GitHub Copilot Chat 扩展是支持 MCP 工具的必要条件。

5. Continue.dev

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 Code Marketplace 或 JetBrains Plugin Marketplace 安装 Continue 扩展
使用你选择的选项，编辑 ~/.continue/config.json
重新加载窗口（Cmd+Shift+P → Reload Window）
打开 Continue 侧边栏 — 聊天中即可使用 WhoisFreaks 工具
提问：Look up IP geolocation for 1.1.1.1

6. Zed Editor

Zed 内置 AI 助手，可通过其 assistant 配置支持 MCP。

配置文件（~/.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 菜单 → 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 [email protected].

# 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 密钥，可从 whoisfreaks.com/billing 获取。全部 14 个工具都使用此密钥直接调用 `api.whoisfreaks.com` — 无需其他变量。

故障排除

API 错误

问题	原因	解决方法
`WHOISFREAKS_API_KEY is not set`	缺少环境变量	在 Docker 命令中添加 `-e WHOISFREAKS_API_KEY=your-key`，或将其添加到客户端配置的 `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)`	积分已用尽	在 whoisfreaks.com/billing 添加积分
`Timeout (HTTP 408)`	上游 WHOIS 服务响应较慢	重试 — 某些 TLD 的 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 配置时未显示工具	应用无法在 PATH 中找到 Docker	使用 Docker 的完整路径：将 `/usr/local/bin/docker` 设为 `command`
`lstat deploy: no such file or directory`（CI/CD）	GitHub Actions 中的相对路径问题	使用 `${{ github.workspace }}/deploy/Dockerfile` 作为绝对路径
网关在端口 3100 上出现 `connection refused`	容器未运行或端口未映射	运行 `docker ps`，确保运行命令中包含 `-p 3100:3100`
SSE 连接几秒后断开	Nginx 代理超时	在 Nginx location 块中添加 `proxy_read_timeout 3600s;`

客户端错误

问题	原因	解决方法
客户端中未显示工具	配置未保存或客户端未重启	保存配置 → 完全退出并重新打开客户端
`UnsupportedClassVersionError`（JAR 模式）	Java 版本过旧	升级到 Java 17+（运行 `java -version` 检查）
JAR 路径错误	配置中使用了相对路径	使用 JAR 的完整绝对路径
Cursor 显示工具但不调用	未启用 Agent 模式	将 Cursor 切换到 Agent 模式，而不是 Chat 模式
Claude Desktop 跳过 whoisfreaks 条目	使用了 SSE URL，而不是 stdio	Claude Desktop 需要 `command`/`args`，而不是 `url`。请使用上文所示的 Docker stdio 配置
Windsurf 未调用工具	Cascade 模式错误	在 Cascade 标题栏中将 Cascade 切换到 Write 模式

链接

WhoisFreaks API 文档： https://whoisfreaks.com/documentation
API 密钥与账单： https://whoisfreaks.com/billing
MCP 协议规范： https://modelcontextprotocol.io
MCP Inspector（测试工具）： npx @modelcontextprotocol/inspector
问题与支持： 在 GitHub 上提交 issue

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

Whoisfreaks

关于 Whoisfreaks

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

WhoisFreaks MCP 服务

目录

工具参考

WHOIS 工具

IP 和 ASN WHOIS 工具

DNS 工具

IP 情报工具

域名工具

SSL 工具

快速开始

⭐ 推荐 — Docker

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

选项 2 — Docker Compose（推荐用于生产环境 / VM）

验证 Docker 是否正常运行

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

从源代码构建

前置条件

平台集成

1. Claude Desktop

2. Cursor IDE

3. Windsurf IDE

4. VS Code + GitHub Copilot

5. Continue.dev

6. Zed Editor

示例提示词

环境变量

故障排除

API 错误

Docker 错误

客户端错误

链接

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？

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