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 许可证