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

如需聯繫，請訪問其個人網站獲取更多信息。