使用说明（Markdown 格式）

项目简介
- Domain Search MCP 是一个完整的 MCP 服务器实现，提供域名可用性查询、跨注册商价格比较、域名变体建议、TLD 信息等功能，并通过 MCP 协议与客户端进行交互。服务器支持多源数据获取（Porkbun、Namecheap、RDAP、WHOIS），并具备缓存、限流、错误处理等能力，便于在 AI 助手中作为上下文服务使用。
主要功能点
- 提供以下 MCP 工具：
  - search_domain：跨若干 TLD 检查域名可用性与价格
  - bulk_search：一次性批量检查多个域名的可用性
  - compare_registrars：对同一域名在不同注册商的价格进行对比
  - suggest_domains：基于基础名称生成并检查可用的变体
  - tld_info：获取指定 TLD 的信息与推荐
  - check_socials：检查社交平台用户名的可用性
- 资源与工具注册：将工具注册到 MCP 服务器，客户端可通过 ListTools 请求获取工具列表，并通过 CallTool 请求执行具体工具。
- 多数据源与回退：优先使用注册商 API，回退到 RDAP/WHOIS，确保在无 API keys 时仍能工作（以 RDAP/WHOIS 为后备）。
- 会话与错误处理：统一的错误封装、日志记录、请求上下文（request_id），便于追踪与调试。
- 安全与性能：内置缓存（TTL 缓存）、限流、日志脱敏，支持 CLI/stdio 的传输模式，便于本地开发与调试。
安装步骤
1. 克隆仓库并进入项目目录
2. 安装依赖
3. 构建产物（dist/server.js）
4. 可选：配置 Porkbun/Namecheap 等 API Key 与环境变量
5. 通过 MCP 客户端连接服务器（下述服务器配置示例中给出启动命令）
6. 启动服务器后即可通过 MCP 客户端发送请求调用工具
服务器配置（MCP 客户端需要的最小信息）配置示例（请将实际路径替换为你的本地路径） { "server_name": "domain-search-mcp", "command": "node", "args": ["/path/to/domain-search-mcp/dist/server.js"] } 说明：
- server_name：在 MCP 客户端侧显示的服务器名称，方便识别与管理。
- command/args：用于启动 MCP 服务器的命令及参数，客户端本身不需要这些信息，只是为 MCP 客户端提供连接信息。上述路径请替换为实际部署后的 server.js 位置。
基本使用方法
- 在 MCP 客户端（如 Claude Desktop、Cursor、Cline 等）中添加一个 MCP 服务器条目，使用上面的启动命令配置即可。然后你可以：
  - 调用 search_domain、bulk_search、compare_registrars、suggest_domains、tld_info、check_socials 等工具，获取结构化的 JSON 响应与人类可读的洞察。
  - 使用返回的结果进行域名购买、品牌规划、社交账号注册等工作流。
运行与调试提示
- 默认情况下，服务器会尝试通过 Porkbun/Namecheap 等 API 提供定价与可用性信息，若未配置 API Key，RDAP/WHOIS 回退将启用。
- 通过日志可以跟踪请求路径、错误原因和调用链，日志实现会掩码敏感信息。

关键词

信息