前言¶
在 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 为准。
