Whodis MCP Server

🚀 Whois MCP 服務器

本項目提供了一個專門用於通過 WHOIS 查詢來檢查域名可用性的模型上下文協議（MCP）服務器。藉助該服務器，AI 助手或其他工具能夠在其工作流程中集成域名可用性檢查功能，為相關業務提供便利。

🚀 快速開始

先決條件

• Node.js (>=18.x)：下載
• Git：用於版本控制

第 1 步：克隆和安裝

# 克隆倉庫
git clone https://github.com/vinsidious/whodis-mcp-server.git
cd whodis-mcp-server

# 安裝依賴項
npm install

第 2 步：運行服務器

# 開發模式運行
npm run dev

# 生產模式運行
npm start

✨ 主要特性

什麼是 MCP？

模型上下文協議（MCP）是一項開放標準，它允許 AI 系統安全且上下文地連接到外部工具和數據源。此服務器實現了 MCP 標準，以提供域名可用信息。

功能

• 域名可用性檢查：使用 whoiser 庫執行 WHOIS 查詢，從而確定域名是否似乎可用或已註冊。
• MCP 工具集成：暴露一個 check-domain-availability 工具供 MCP 客戶端（如 AI 助手）使用。
• CLI 接口：包括一個命令行接口 (whodis-mcp-server check-domain-availability ...) 用於直接使用和測試。
• 結構化日誌記錄：提供詳細的日誌記錄，方便進行調試和監控。
• 可配置性：支持通過環境變量或 .env 文件進行配置。

功能概覽

MCP 服務

• 檢查域名可用性：通過 WHOIS 查詢檢查指定域名的註冊狀態。
• 獲取註冊信息：提取和顯示已註冊域名的詳細信息，例如註冊商、到期日期等。

CLI 工具

• 交互式模式：允許用戶輸入域名並獲得即時反饋。
• 批量處理：支持一次性檢查多個域名的可用性。

🔧 技術細節

項目架構

核心組件

• WHOIS 查詢器：負責執行 WHOIS 數據檢索和解析。
• MCP 接口適配器：實現與 MCP 協議兼容的 API 端點。
• 日誌系統：記錄所有操作，用於審計和故障排除。

代碼結構

whodis-mcp-server/
├── src/                 # 源代碼目錄
│   ├── whois.js         # WHOIS 查詢實現
│   ├── mcp-interface.js # MCP 協議適配器
│   └── logger.js        # 日誌記錄模塊
├── package.json          # 依賴管理文件
└── .env.example           # 環境變量示例文件

📚 詳細文檔

開發指南

安裝依賴

npm install

運行測試

npm test

調試日誌

DEBUG=true npm start

配置

• 環境變量：

  export MCP_SERVER_PORT=3000
  export WHOIS_API_KEY=your_api_key
  

發佈流程

1. 提交更改並遵循約定提交消息（例如 feat:、fix:、chore:）。
2. 推送更改到主分支。
3. 位於 .github/workflows/ci-semantic-release.yml 的工作流將自動執行構建、測試、版本控制和 npm 發佈。

📄 許可證

ISC 許可證