WHOIS MCP

WHOIS MCP

一个以模型上下文协议（MCP）服务形式实现的 WHOIS 查询服务。

概述

WHOIS MCP 是一个 Java 应用程序，通过模型上下文协议提供 WHOIS 查询功能。它允许用户通过标准化接口查询域名的 WHOIS 信息。服务通过标准输入/输出进行通信，因此兼容 MCP 客户端。

演示

https://github.com/user-attachments/assets/037a30de-c330-4dd4-93c2-2add936b9caf

https://github.com/user-attachments/assets/2a91045a-b922-4832-9500-dc9eacb54ee0

https://github.com/user-attachments/assets/befbb1e0-137c-4534-b7f7-433305a41755

功能

• 域名验证与清理
• 缓存 WHOIS 服务信息
• 未找到特定服务时回退至 IANA WHOIS 服务
• 全面的错误处理
• 与模型上下文协议集成

安装

前置条件

• Java 21 或更高版本
• Maven 3.6 或更高版本

构建项目

1. 克隆代码库：

   git clone https://github.com/asjordi/whois-mcp.git
   cd whois-mcp
   

2. 使用 Maven 构建：

   mvn clean package
   

这将在 target 目录中创建一个可执行 JAR 文件。

3. 你可以在常用的 IDE（例如 IntelliJ IDEA、Eclipse）中打开项目，以便更轻松地进行开发和调试。

调试服务

要调试服务，可以使用 MCP Inspector。

1. 首先使用以下命令构建项目：

mvn clean package

2. 使用以下命令运行 MCP Inspector：

npx @modelcontextprotocol/inspector

3. 设置以下值：

• 传输方式：STDIO
• 命令：java
• 参数：-jar PATH\\target\\whois-mcp-1.0-SNAPSHOT.jar

4. 点击 Connect 按钮，启动 MCP Inspector 并连接到服务。

使用方法

配置完成后，任何支持该协议的 MCP 客户端都可以自动使用 WHOIS MCP 服务。

Claude

前往菜单 > 文件 > 设置 > 开发者 > 编辑配置，并将以下内容添加到 claude_desktop_config.json 文件中：

{
   "mcpServers": {
      "whois-mcp-server": {
         "command": "java",
         "args": [
            "-jar",
            "PATH\\target\\whois-mcp-1.0-SNAPSHOT.jar"
         ]
      }
   }
}

保存文件并重启应用。现在，你可以向 WHOIS MCP 服务发送请求来使用它。

VSCode

打开 settings.json 并添加以下配置：

"mcp": {
 "servers": {
   "whois-mcp-server": {
     "type": "stdio",
     "command": "java",
     "args": [
       "-jar",
       "PATH\\whois-mcp\\target\\whois-mcp-1.0-SNAPSHOT.jar"
     ]
   }
 }
}

保存文件并重启应用。打开 Copilot 并将模式设置为 Agent，即可使用 WHOIS MCP 服务。

项目结构

项目围绕以下关键组件构建：

主要组件

• Main：应用程序的入口点，用于初始化并启动 MCP 服务。
• WhoisService：核心服务，使用 Apache Commons Net 库执行 WHOIS 查询。
• WhoisCache：根据域名后缀缓存 WHOIS 服务信息。
• DomainValidatorUtil：使用 Apache Commons Validator 验证域名。
• DomainSanitizer：清理域名，移除不必要的字符并确保格式正确。
• McpException：用于处理 WHOIS MCP 服务特定错误的自定义异常类。

流程

1. MCP 服务接收包含域名的请求。
2. 验证并清理域名。
3. 根据域名后缀，从缓存中确定适用的 WHOIS 服务。
4. 向该服务执行 WHOIS 查询。
5. 通过 MCP 协议将结果返回给客户端。

WHOIS 服务映射

WHOIS 服务映射配置在 whois-servers.properties 文件中，该文件将顶级域名映射到相应的 WHOIS 服务。如果此文件不可用，则使用默认的服务列表。

依赖项

• 模型上下文协议 SDK：用于实现 MCP 服务
• SLF4J：用于日志记录
• Apache Commons Net：用于 WHOIS 客户端功能
• Apache Commons Validator：用于域名验证
• JUnit Jupiter：用于测试

测试

项目包含所有组件的全面单元测试。使用以下命令运行测试：

mvn test

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

Author

Jordi Ayala - asjordi.dev

Root Zone Database