Whoisfreaks MCP Server

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）。

______________________________________________________________________

目录

1. 工具参考（14个工具）
2. 快速开始

- - 从源代码构建

1. 先决条件
2. 平台集成

- 1.克劳德桌面 - 2.光标IDE - 3.风帆IDE - - 5.继续开发 - 6.Zed编辑

1. 示例提示
2. 故障排除

______________________________________________________________________

工具参考

WHOIS工具

IP和ASN WHOIS工具

DNS工具

IP智能工具

域名工具

SSL工具

______________________________________________________________________

快速开始

⭐ 推荐——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与容器通信。

______________________________________________________________________

从源代码构建

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

先决条件：

克隆和构建：

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

______________________________________________________________________

先决条件

______________________________________________________________________

平台集成

1.克劳德桌面

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

配置文件位置：

______________________________________________________________________

⭐ 选项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"
      }
    }
  }
}

______________________________________________________________________

步骤（两个选项）：

1. 将上面的配置粘贴到配置文件中（如果不存在，则创建它）
2. 保存文件
3. 完全退出克劳德桌面(Cmd+Q 在Windows上的macOS/任务栏退出）
4. 重新打开克劳德桌面
5. 点击 锤图标 聊天输入中的（工具）-您应该看到列出了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"
      }
    }
  }
}

步骤：

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

______________________________________________________________________

3.风帆IDE

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

配置文件位置：

⭐ 选项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"
      }
    }
  }
}

步骤：

1. 使用您选择的选项保存配置
2. 重新启动Windsurf
3. 打开Cascade侧边栏→ 查找MCP工具指示灯（插头图标）
4. 问： 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"
      }
    }
  }
}

步骤：

1. 确保你有 GitHub Copilot 聊天助手 已安装扩展（v1.99+）
2. 使用您选择的选项保存上面的配置文件
3. 打开Copilot聊天(Ctrl+Shift+I / Cmd+Shift+I)
4. 将模型切换到 代理模式 使用下拉菜单
5. 点击 工具 按钮——WhoisFreaks工具应出现在列表中
6. 问： 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"
      }
    }
  ]
}

步骤：

1. 安装 继续 来自VS代码市场或JetBrains插件市场的扩展
2. 编辑 ~/.continue/config.json 根据您选择的选项
3. 重新加载窗口(Cmd+Shift+P → Reload Window)
4. 打开继续侧栏——WhoisFreaks的工具将在聊天中可用
5. 问： 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"
        }
      }
    }
  }
}

步骤：

1. 打开Zed→ Zed menu → Settings （或 Cmd+,)
2. 添加 mcp_servers 使用所选选项阻止现有设置JSON
3. 保存并重新启动Zed
4. 打开AI面板(Cmd+?) → 工具将列在工具指示器下
5. 问： 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?

______________________________________________________________________

环境变量

______________________________________________________________________

故障排除

API错误

Docker错误

客户端错误

______________________________________________________________________

链接

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