🚀 WHOIS MCP 服务
WHOIS MCP 服务是一个基于模型上下文协议（MCP）实现的 WHOIS 查询服务。它以 Java 应用程序的形式，借助标准化接口为用户提供域名 WHOIS 信息查询功能，且该服务器通过标准输入输出进行通信，与 MCP 客户端兼容。
🚀 快速开始
WHOIS MCP 是一个 Java 应用程序，它基于 Model Context Protocol 提供 WHOIS 查询功能。用户能够通过该服务，利用标准化接口查询域名的 WHOIS 信息。此服务器支持标准输入输出通信，可与 MCP 客户端完美兼容。
👀 演示
✨ 主要特性
- 域名验证与清理：确保查询的域名有效，并处理无效或错误的输入。
- WHOIS 查询：通过 Apache Commons Net 库实现对域名注册信息的查询。
- 日志记录：使用 SLF4J 记录操作日志，便于调试和维护。
- 模块化设计：各组件独立，便于扩展和维护。
- 测试覆盖：提供全面的单元测试，确保代码质量。
📦 安装指南
先决条件
- Java Development Kit (JDK) 8 或更高版本
- Apache Maven 3.6 或更高版本
构建步骤
- 下载项目源码：
git clone https://github.com/your-repository.git cd whois-mcp - 使用 Maven 进行构建：
mvn clean install - 运行服务器：
java -jar target/whois-mcp.jar
🐞 调试指南
使用 MCP Inspector 工具进行调试
- 下载并安装 MCP Inspector。
- 打开工具，连接到运行中的 WHOIS MCP 服务。
- 使用工具界面发送查询请求，并查看响应结果。
💻 使用示例
针对 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: 提供辅助功能，如日志记录和配置管理。
主要组件
- WhoIsMcpApplication：负责应用程序的启动和配置。
- DomainValidator：确保输入的域名有效。
- WhoIsClient：使用 Apache Commons Net 库进行 WHOIS 查询。
- Logger：记录操作日志，便于调试。
工作流程
- 用户发送域名查询请求到服务器。
- 服务器接收请求，调用
DomainValidator进行验证。 - 验证通过后，使用
WhoIsClient发起 WHOIS 查询。 - 处理返回结果，并将其格式化为响应返回给用户。
Whois 服务器映射
项目依赖于 IANA 的 根区域数据库，获取顶级域名的信息。
依赖项
| 属性 | 详情 |
|---|---|
| 模型类型 | Model Context Protocol (MCP) - 用于实现 MCP 协议 |
| 日志记录库 | SLF4J - 便于调试和维护 |
| WHOIS 客户端功能库 | Apache Commons Net - 提供 WHOIS 客户端功能 |
| 域名验证库 | Apache Commons Validator - 用于域名验证 |
| 单元测试框架 | JUnit Jupiter |
测试方法
运行以下命令执行单元测试：
mvn test
📄 许可证
本项目遵循 MIT 许可证，具体内容请查看 LICENSE 文件。
👨💻 作者信息
Jordi Ayala - asjordi.dev
如需联系，请访问其个人网站获取更多信息。