Whois MCP

🚀 WHOIS MCP 服务

WHOIS MCP 服务是一个基于模型上下文协议（MCP）实现的 WHOIS 查询服务。它以 Java 应用程序的形式，借助标准化接口为用户提供域名 WHOIS 信息查询功能。该服务器通过标准输入输出进行通信，与 MCP 客户端兼容。

🚀 快速开始

WHOIS MCP 是一个 Java 应用程序，通过 Model Context Protocol 提供 WHOIS 查询功能。用户可利用此服务查询域名的 WHOIS 信息，且使用的是标准化接口。该服务器支持标准输入输出通信，与 MCP 客户端兼容。

以下是演示链接：

• 演示链接 1
• 演示链接 2
• 演示链接 3

✨ 主要特性

1. 🔍 域名验证与清理：确保查询的域名有效，并处理无效或错误的输入。
2. 📋 WHOIS 查询：通过 Apache Commons Net 库实现对域名注册信息的查询。
3. 📝 日志记录：使用 SLF4J 记录操作日志，便于调试和维护。
4. 🧩 模块化设计：各组件独立，便于扩展和维护。
5. ✅ 测试覆盖：提供全面的单元测试，确保代码质量。

📦 安装指南

⚙️ 先决条件

• Java Development Kit (JDK) 8 或更高版本
• Apache Maven 3.6 或更高版本

🏗️ 构建步骤

1. 下载项目源码：

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

2. 使用 Maven 进行构建：

   mvn clean install
   

3. 运行服务器：

   java -jar target/whois-mcp.jar
   

💻 使用示例

👨‍💻 针对 Claude 用户

将以下配置添加到你的 settings.json 文件中：

{
  "whoisMcp": {
    "serverUrl": "http://localhost:8080",
    "apiKey": "your_api_key"
  }
}

💻 针对 VSCode 用户

在终端中运行以下命令启动服务：

cd whois-mcp
mvn spring-boot:run

📚 详细文档

📁 项目结构

• Main Class：com.whoismcp.WhoIsMcpApplication - 应用程序的主入口。
• Controllers：处理 HTTP 请求，返回 WHOIS 查询结果。
• Services：包含实际业务逻辑，如域名验证和 WHOIS 查询。
• Utils：提供辅助功能，如日志记录和配置管理。

🧰 主要组件

1. WhoIsMcpApplication：负责应用程序的启动和配置。
2. DomainValidator：确保输入的域名有效。
3. WhoIsClient：使用 Apache Commons Net 库进行 WHOIS 查询。
4. Logger：记录操作日志，便于调试。

🔄 工作流程

1. 用户发送域名查询请求到服务器。
2. 服务器接收请求，调用 DomainValidator 进行验证。
3. 验证通过后，使用 WhoIsClient 发起 WHOIS 查询。
4. 处理返回结果，并将其格式化为响应返回给用户。

🌐 Whois 服务器映射

项目依赖于 IANA 的 根区域数据库，获取顶级域名的信息。

📌 依赖项

• Model Context Protocol (MCP)：用于实现 MCP 协议。
• SLF4J：日志记录库，便于调试和维护。
• Apache Commons Net：提供 WHOIS 客户端功能。
• Apache Commons Validator：用于域名验证。
• JUnit Jupiter：单元测试框架。

🧪 测试方法

运行以下命令执行单元测试：

mvn test

🔧 技术细节

WHOIS MCP 服务依赖于 IANA 的根区域数据库获取顶级域名信息，为 WHOIS 查询提供基础数据支持。在实现过程中，使用了多个关键的库和框架。Model Context Protocol (MCP) 用于实现 MCP 协议，确保服务与客户端之间的通信遵循标准协议。SLF4J 作为日志记录库，方便开发人员在调试和维护过程中查看操作日志。Apache Commons Net 库提供了 WHOIS 客户端功能，使得服务能够发起有效的 WHOIS 查询。Apache Commons Validator 则用于域名验证，保证输入的域名是有效的。JUnit Jupiter 作为单元测试框架，为代码的质量提供了保障，通过运行 mvn test 命令可以执行全面的单元测试。

📄 许可证

本项目遵循 MIT 许可证，具体内容请查看 LICENSE 文件。

👨‍💼 作者信息

Jordi Ayala - asjordi.dev

如需联系，请访问其个人网站获取更多信息。