使用说明
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进行测试
- 打开邮递员→ 连接到MCP
- 添加连接:
http://localhost:8000
- 调用工具:
search_domains
请求示例:
{
"query": "apple",
"tlds": [".com", ".io", ".ai"],
"max_results": 25,
"include_taken": true
}
答复包括:
exact_matchessimilar_matchesavailable和is_premiumfastly_status(API原始值)namecheap_buy_url