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
   

🐞 调试指南

使用 MCP Inspector 工具进行调试

1. 下载并安装 MCP Inspector。
2. 打开工具，连接到运行中的 WHOIS MCP 服务。
3. 使用工具界面发送查询请求，并查看响应结果。

💻 使用示例

针对 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 的 根区域数据库，获取顶级域名的信息。

依赖项

测试方法

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

mvn test

📄 许可证

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

👨‍💻 作者信息

Jordi Ayala - asjordi.dev

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