前言¶
在 DeepSeek Harness（DSH）裏做域名、DNS、Nameserver 或聯繫人相關任務時，理想情況是智能體直接調用工具，而不是讓你手動登錄 Namecheap 控制台再複製結果。Namecheap 已在 https://mcp.namecheap.com/mcp 提供官方 MCP 服務，但該服務走 Streamable HTTP 與 OAuth 2.0（PKCE、動態客戶端註冊）。DSH 內置的 @deepseek-ai/dsh-mcp-client 只支持 stdio 和帶靜態 header 的 HTTP，無法完成 OAuth 流程。
社區插件 dsh-namecheap-mcp（維護者 2000lla，分類：聯網工具）在本機用 mcp-remote 做協議橋接，把 Namecheap 官方 MCP 接到 DSH 的 stdio 傳輸上。裝好後，域名列表、DNS 讀寫、Nameserver、聯繫人等會以 mcp__namecheap__* 前綴出現在對話裏。插件爲 MIT 許可的非官方社區項目，與 Namecheap, Inc. 無隸屬或背書關係。
這是什麼¶
dsh-namecheap-mcp 是 Namecheap 官方 MCP 的 DeepSeek Harness 連接器：純配置包，無運行時代碼，通過 cordis.patch.yml 讓 DSH 啓動 npx mcp-remote 指向 https://mcp.namecheap.com/mcp，由 mcp-remote 處理 OAuth 並在本地緩存 token。
橋接關係可概括爲：
DSH 插件（純配置）
└─ @deepseek-ai/dsh-mcp-client ← transport: stdio
└─ npx mcp-remote https://mcp.namecheap.com/mcp
└─ OAuth 2.0 → namecheap.com 官方登錄頁
└─ token 緩存於 ~/.mcp-auth/mcp-remote-v1/
當前 package 版本爲 1.1.0（以倉庫 package.json 爲準）。
核心功能¶
插件暴露 12 個 MCP 工具，在 DSH 中名稱帶 mcp__namecheap__ 前綴（與 README 中工具名對應，實際調用名以 DSH 展示爲準）。
| 能力 | 讀寫 | 說明 |
|---|---|---|
| 域名列表 | 讀 | 列出賬號下域名 |
| 域名可用性 | 讀 | 批量檢查 1–20 個域名是否可註冊 |
| DNS 記錄查詢 | 讀 | 分頁讀取，支持過濾 |
| 聯繫人 | 讀 | 列表與單條詳情 |
| DNS 保存 / 刪除 | 寫 | 新增或改 TTL；刪除記錄（TXT 大小寫敏感） |
| Nameserver | 寫 | 修改註冊商級 Nameserver |
| 域名聯繫人 | 寫 | 修改 registrant / admin / tech / billing |
| 聯繫人保存 | 寫 | 新建聯繫人 |
| 域名註冊 | 寫 | 註冊域名 |
| 購買鏈接 | 讀 | 生成走 Namecheap 官方支付頁的鏈接 |
寫操作沒有二次確認，會直接作用真實域名；README 建議先用讀類工具驗證連通性。
安裝與啓用¶
在指定 profile 下安裝（命令來自倉庫 README）：
dsh plugin --profile <profile> add dsh-namecheap-mcp
或從 GitHub 安裝：
dsh plugin --profile <profile> add github:2000lla/dsh-namecheap-mcp
安裝完成後重啓 DSH，工具列表中應出現 mcp__namecheap__ 前綴的工具。
認證與配置要點¶
首次 OAuth¶
第一次調用任意 Namecheap 工具時，mcp-remote 會打開瀏覽器，跳轉到 Namecheap 自己的登錄/授權頁。密碼只在 namecheap.com 輸入，不經過 DSH，也不會寫入插件配置文件；插件側只保存 OAuth token。
- access token 有效期約 20 分鐘，之後用 refresh token 自動續期
- token 目錄：
~/.mcp-auth/mcp-remote-v1/ - 授權 scope：
mcp.namecheap.com.read、mcp.namecheap.com.write、offline_access - 需重新授權時：刪除該目錄下對應 hash 的
*_tokens.json，再重啓 DSH
mcp-remote 在授權階段於 127.0.0.1 起 OAuth 回調端口（默認 3334）。
cordis.patch.yml¶
| 字段 | 值 | 說明 |
|---|---|---|
serverName |
namecheap |
工具前綴 mcp__namecheap__ |
transport |
stdio |
經 mcp-remote 橋接 |
command / args |
!!js 按平臺求值 |
Windows 用 cmd /c；macOS/Linux 用 /bin/sh -c 並補 Homebrew PATH |
toolCallTimeoutMs |
120000 |
首次調用需等待 npx 與 OAuth |
failOnStartupError |
true |
啓動失敗時插件不激活，不拖垮 harness |
macOS 從 Finder/Dock 啓動的 GUI 應用 PATH 往往不含 Homebrew，插件在 shell 裏執行前會追加 /opt/homebrew/bin、/usr/local/bin。Node 裝在 nvm 等路徑時，需把 which npx 得到的路徑加入 PATH=，或將 npx 改爲絕對路徑。倉庫 pinned 的橋接命令使用 mcp-remote@0.15.2。
典型用法¶
在 DSH 對話中直接描述意圖，由智能體選擇對應工具，例如：
- 用讀類工具列出域名、拉取某域名的 DNS 記錄，確認賬號與 MCP 連通。
- 需要改解析時，說明主機記錄類型與目標值，由智能體調用 DNS 保存類寫工具（操作前自行覈對記錄，避免誤刪）。
- 查可用性、生成購買鏈接、改 Nameserver 或聯繫人時，同樣通過自然語言觸發相應
mcp__namecheap__*工具。
README 未提供固定 prompt 模板；可復現路徑是「安裝 → 重啓 → 首次調用觸發 OAuth → 讀工具驗通 → 再謹慎使用寫工具」。
適用場景與注意¶
適合：已在 Namecheap 託管或註冊域名，希望在 DSH 智能體對話裏查改 DNS、Nameserver、聯繫人，而不反覆打開控制台。
務必注意：
- 插件以當前 DSH 進程的用戶權限運行；安裝前建議查看 GitHub 倉庫 源碼與 MIT 許可證。
- 寫類工具會改動生產域名與註冊信息，授權 OAuth 時確認 scope，日常對話中避免誤觸發寫操作。
- 需要本機可用的 Node/npx；首次工具調用超時配置爲 120 秒，網絡或 npx 解析慢時需耐心等待。
- 社區插件目錄見 SkillHub 插件頁，與 DeepSeek / 幻方無官方從屬關係；DSH 生態理念是「一切皆插件」，本連接器解決的是 OAuth MCP 與 DSH stdio 客戶端之間的缺口。
結尾¶
dsh-namecheap-mcp 把 Namecheap 官方 MCP 經 mcp-remote 接到 DSH，在對話裏以 mcp__namecheap__* 工具管理域名、DNS、Nameserver 與聯繫人。安裝命令見上文；細節與安全說明以倉庫 README 爲準。
