域名搜索服务

一个提供域名搜索、模糊建议和可用性查询的MCP服务器,支持快速购买链接。

  • by aarya-rapid
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 aarya-rapid/namecheap-mcp

使用说明

Namecheap MCP–域名搜索服务器

一种模型上下文协议(MCP)服务器,提供 域搜索, 模糊领域建议,以及 可用性查询 使用 Fastly领域研究API,与 Namecheap购买链接 为了快速购买。

这是为MCP兼容客户端(如Postman MCP、AI代理)使用而设计的。


🚀 特性

  • 自然语言查询中的模糊域搜索
    → "apple", "cool ai studio", "apple.com" 等等
  • 精确匹配检测
    → apple.com, apple.io, apple.ai
  • 类似/可品牌化的变化
    → getapple.com, tryapple.io, applehq.ai等等。
  • 通过以下方式提供实时域名 Fastly领域研究API
  • 检测到时标记高级域名
  • 提供 直接Namecheap购买链接 对于每一个建议
  • 完全异步+快速响应时间

🧠 它是如何工作的(高级)

层 目的
控制器 暴露MCP工具
服务 模糊搜索逻辑、评分、结果合并
仓库 Fastly领域研究API集成
模型 用于请求/响应的Pydantic模式
服务器 通过流式HTTP传输启动MCP服务器

Fastly API仅用于确定 可用性+高级状态.
价格还不包括在内,但可以稍后添加(Porkbun、Namecheap API等)。


📂 项目结构

namecheap-mcp/
 ├─ src/
 │   └─ namecheap_mcp/
 │       ├─ server.py
 │       ├─ config.py
 │       ├─ controllers/
 │       ├─ services/
 │       ├─ repositories/
 │       ├─ models/
 ├─ pyproject.toml
 ├─ .env.example
 ├─ README.md

🔧 需求

  • Python 3.12+
  • uv (推荐)或诗歌
  • MCP兼容客户端(建议使用Postman MCP)

📥 设置

1.️⃣ 安装依赖项

uv sync

2.️⃣ 创建 .env 项目根目录中的文件:

FASTLY_API_TOKEN=your_fastly_api_token_here
MCP_HOST=0.0.0.0
MCP_PORT=8000

.env 不得承诺。它被忽略了 .gitignore.

3.️⃣ 运行MCP服务器

uv run python -m namecheap_mcp.server

🧪 使用Postman MCP进行测试

  1. 打开邮递员→ 连接到MCP
  2. 添加连接:
http://localhost:8000
  1. 调用工具:
search_domains

请求示例:

{
  "query": "apple",
  "tlds": [".com", ".io", ".ai"],
  "max_results": 25,
  "include_taken": true
}

答复包括:

  • exact_matches
  • similar_matches
  • available 和 is_premium
  • fastly_status (API原始值)
  • namecheap_buy_url