IP2WHOIS

IP2WHOIS MCP 服务

一个模型上下文协议（MCP）服务，使用 IP2WHOIS API 提供全面的 WHOIS 查询功能。此服务允许 AI Agent 查询域名注册详情，包括到期日期、注册商信息和注册人数据。此服务还支持按 IP 地址查询托管的域名。

功能

• 域名查询：获取任意域名的详细 WHOIS 数据。

• 托管域名查询：获取任意 IP 地址所托管的域名数据。

• 全面的数据：包括域名年龄、名称服务器、注册商信息以及管理和账单联系人详情。

• FastMCP 框架：使用高性能的 FastMCP Python 框架构建。

要求

此 MCP 服务需要 API 密钥才能运行。你可以注册免费 API 密钥，每月最多可享受 500 次查询。

本地 MCP 服务的设置也会用到 uv，可按照指南安装。

设置

使用此 MCP 服务有两种方式：

• 云托管 MCP 服务：直接连接到托管的 IP2WHOIS MCP 服务。无需在本地安装任何内容。
• 本地 MCP 服务：使用 uv 下载服务并在自己的计算机上运行。

选项 1：云托管 MCP 服务

如果你想直接连接到托管服务，请使用此选项。

方法 A：直接 HTTP 连接

如果你的 MCP 客户端支持通过 HTTP 连接远程服务，请使用此方法。无需 uv、Node.js 或 npx。

{
  "mcpServers": {
    "ip2whois": {
      "type": "http",
      "url": "https://mcp.ip2whois.com/",
      "headers": {
        "X-API-Key": "<YOUR API key HERE>"
      }
    }
  }
}

如果你的客户端通过命令行进行配置，例如 Claude Code，可以使用以下命令添加服务：

claude mcp add --transport http ip2whois https://mcp.ip2whois.com/ --header "X-API-Key: <YOUR API key HERE>"

方法 B：通过 npx 连接

如果你的 MCP 客户端仅支持本地（stdio）服务，请使用此方法。mcp-remote 包会在本地运行，并将请求转发到托管服务。此方法需要 Node.js。

{
  "mcpServers": {
    "ip2whois": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.ip2whois.com/",
        "--header",
        "X-API-Key:<YOUR API key HERE>"
      ]
    }
  }
}

要获取 API 密钥，只需登录控制面板并从中获取，然后将上方示例中的 <YOUR API key HERE> 替换为你的实际 API 密钥。

保存更改后，重启 Claude Desktop，你应该会在 Search and tools 菜单中看到它。

选项 2：本地 MCP 服务

按照以下步骤在自己的计算机上运行 MCP 服务：

1. 设置 uv 包管理器，可以再次参考指南。
2. 确保已安装 Claude Desktop。如果尚未安装，Windows 和 MacOS 用户请从此处下载，Linux 用户请按照此指南操作。
3. 在你选择的编辑器中打开 claude_desktop_config.json。如果还没有该文件，请按照此指南创建。
4. 将以下内容添加到 claude_desktop_config.json 中：

{
  "mcpServers": {
    "ip2whois": {
      "command": "uvx",
      "args": ["mcp-ip2whois"],
      "env": {
        "IP2WHOIS_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}

5. 要获取 API 密钥，只需登录控制面板并从中获取。将上方示例中的 <YOUR API key HERE> 替换为你的实际 API 密钥。
6. 保存更改后，重启 Claude Desktop，你应该会在 Search and tools 菜单中看到它。

用法

要查询 WHOIS 信息，只需在 Claude Desktop 的聊天中输入有关域名的问题。以下是一些示例问题：

• 谁是（域名）的注册商？
• （域名）的所有者是谁？
• （域名）的 WHOIS 信息是什么？

例如，以下是域名 google.com 的查询结果：

要查询某个 IP 地址托管的域名，只需在 Claude Desktop 的聊天中输入有关该 IP 的问题。以下是一些示例问题：

• （IP）托管了哪些域名？
• （IP）上有哪些域名？
• （IP）拥有的域名是什么？

在 Claude Desktop 中，模型会根据 IP2WHOIS MCP 服务返回的结果自动生成输出。

环境变量

IP2WHOIS_API_KEY

IP2WHOIS API 密钥，可让你每月免费查询最多 500 次，并获取更详细的 IP 地址信息。你可以注册免费 API 密钥，或订阅套餐以享受更多权益。

工具

get_whois

查询域名的 WHOIS 数据。

• 参数：

  • domain（字符串）：要查询的域名（例如，google.com）。

• 输出：返回包含以下内容的 JSON 对象：

  • domain_id、status、domain_age

  • create_date、update_date、expire_date

  • registrar（名称、网址等）

  • registrant（姓名、组织、国家/地区）

  • nameservers

get_hosted_domains

查询某个 IP 地址托管的域名列表。

• 参数：

  • ip（字符串）：要查询的 IP 地址（IPv4 或 IPv6）。

• 输出：返回一个 JSON 对象，其中包含该 IP 地址上托管的域名，以及找到的托管域名总数

许可证

请参阅 LICENSE 文件。