MCP Namecheap Registrar

🚀 Namecheap 域名 MCP 用於 Cursor

這是一個為 Cursor AI 接口提供 Cursor MCP（模型上下文協議）集成的 Namecheap 域名 API。藉助該 API，您能夠檢查域名可用性、獲取定價信息，還能直接通過 Cursor 註冊域名。

YouTube 實際操作演示：

🚀 快速開始

此工具默認使用 Namecheap 的即時 API，進行實際的域名購買。在運行腳本之前，請務必仔細閱讀文檔，並理解所有可能的安全注意事項。

✨ 主要特性

1. 檢查域名可用性
   • 可檢查單個或多個域名的可用性。
   • 支持多種頂級域名（TLD）。
2. 獲取定價信息
   • 顯示註冊、續費和轉移價格。
   • 支持不同年份的價格顯示。
3. 註冊域名
   • 可使用默認設置或自定義選項註冊域名。
   • 支持自定義 DNS 服務器。
   • 支持啟用或禁用 Whois 隱私保護。
4. 沙盒模式
   • 提供測試環境，不會進行實際購買。
   • 使用獨立的 API 密鑰和賬戶。

📦 安裝指南

安裝依賴項

npm install namecheap-api cursor-mcp

配置步驟

1. 創建 .env 文件 在項目根目錄下創建一個 .env 文件，並添加以下內容：

NAMECHEAP_API_KEY=your_api_key_here
NAMECHEAP_USERNAME=your_username_here
REGISTRANT_PROFILE=registrant-profile.json

2. 準備註冊人配置文件 創建 registrant-profile.json 文件，確保包含以下字段：

{
    "name": "John Doe",
    "address1": "123 Main St",
    "city": "Anytown",
    "state": "CA",
    "postalcode": "12345",
    "country": "US",
    "phonenumber": "+1.5555555555",
    "email": "email@example.com"
}

💻 使用示例

檢查域名可用性

node check-availability.js example.com anotherexample.net

獲取定價信息

node get-pricing.js example.com

註冊域名

註冊過程分為兩步，以確保安全：

1. 第一步 - 顯示詳細信息

node register-domain.js --step=1 example.com

2. 第二步 - 確認購買 在第一步完成後，系統會提示您輸入確認碼。請仔細檢查所有信息後，輸入 confirm。

沙盒模式

為了測試目的，在 .env 文件中設置：

NODE_ENV=sandbox

這將使用 Namecheap 的沙盒 API 環境，不會進行實際購買。請確保您擁有獨立的沙盒 API 憑證。

📚 詳細文檔

常見問題

1. 如何獲取 API 密鑰？

登錄您的 Namecheap 賬戶，進入“用戶中心” > “API”部分，生成新的 API 密鑰。

2. 需要哪些權限？

確保您的 API 密鑰具有以下權限：

• Domain Services：Read/Write
• WHOISguard Services：Read/Write

3. 如何處理錯誤？

a. 認證失敗

• 確保您的 API 密鑰和用戶名正確。
• 檢查您的 IP 地址是否在 Namecheap 的白名單中。

b. 註冊人配置文件未找到

• 驗證 registrant-profile.json 文件是否存在。
• 確保文件包含有效的 JSON 格式，並且所有必填字段都已填寫。

c. 域名註冊失敗

• 檢查您的 Namecheap 賬戶餘額。
• 確認域名確實可用。
• 確保註冊人配置文件中的信息完整無誤。

📄 許可證

本項目遵循 MIT 許可證 - 請查看 LICENSE 文件以獲取詳細信息。

為項目做貢獻

歡迎任何貢獻！請參閱 CONTRIBUTING.md 瞭解如何為該項目做出貢獻。

⚠️ 重要提示

此工具默認使用 Namecheap 的即時 API，進行實際的域名購買。確保在運行腳本之前，您已經仔細閱讀了文檔，並且理解所有可能的安全注意事項。