Domeneshop

MCP（Model Context Protocol）是一种开放标准，可让 AI 应用调用外部工具。这个软件包是一个 MCP 服务： 一个由 AI 应用在后台启动并与之通信的小程序。注册后，你只需用日常语言提出请求——“将 blog.example.no 指向 203.0.113.10”——助手就会选择合适的工具，向你展示即将执行的操作，并在更改任何内容前征求你的同意。

你无需自行运行该服务，也不需要知道工具名称。你需要：

• Domeneshop API 令牌和密钥：一对允许程序操作你账户的密钥。请像对待密码一样妥善保管。
• MCP 客户端：你用来聊天的应用。下文以 Claude Code 为例；其他客户端也可以（请参阅客户端设置）。
• Node.js 20.3+（下载 LTS 版本）或 Homebrew。Claude Desktop 捆绑包无需此项。

如果你不确定是否要让助手更改正在使用的 DNS，可以从只读模式开始：它可以查看所有内容，但无法进行更改。

使用快速入门中的 CLI 命令。默认使用 --scope local，仅对你和此项目可见。使用 --scope project 可改为写入 <your-project>/.mcp.json，并通过版本控制共享；使用 --scope user 则适用于你账户下的所有项目。

你也可以将标准配置作为原始 JSON 传入：

claude mcp add-json domeneshop '{"command":"npx","args":["-y","domeneshop-mcp"],"env":{"DOMENESHOP_API_TOKEN":"<your-api-token>","DOMENESHOP_API_SECRET":"<your-api-secret>"}}'

或者直接将标准配置写入 <your-project>/.mcp.json。 claude mcp list 会显示已注册的服务及其连接状态。

最简单的方式是一键安装包，无需 Node.js：

1. 从最新版本下载 domeneshop-mcp-<version>.mcpb。
2. 打开它（双击，或将其拖入 Claude Desktop）。
3. 粘贴你的令牌和密钥，可选开启只读模式，然后安装。

Claude Desktop 会安全地存储凭据。

若要手动配置，请将标准配置添加到 claude_desktop_config.json。可通过“设置” →“开发者”→“编辑配置”找到该文件，然后重启 Claude Desktop：

该按钮会使用占位凭据安装服务。Cursor 无法提示你输入凭据，因此安装后请打开 设置 → MCP，编辑 domeneshop 条目，并将 <your-api-token> 和 <your-api-secret> 替换为你自己的值。

若要手动设置，请将标准配置添加到 mcp.json 文件：

这些按钮会将服务安装到用户配置中。随后，VS Code 会提示你输入 token 和 secret，并安全地存储它们，因此不会以明文形式写入配置文件。

如果要手动设置，请注意，VS Code 使用 servers 键而不是 mcpServers，并且要求显式指定 type。仅针对本项目，请将其添加到 <your-project>/.vscode/mcp.json：

{
  "servers": {
    "domeneshop": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "domeneshop-mcp"],
      "env": {
        "DOMENESHOP_API_TOKEN": "<your-api-token>",
        "DOMENESHOP_API_SECRET": "<your-api-secret>"
      }
    }
  }
}

若要应用于每个项目，请运行命令面板操作 MCP: Open User Configuration 并在那里添加相同的代码块，或者用一行命令注册：

code --add-mcp '{"name":"domeneshop","command":"npx","args":["-y","domeneshop-mcp"],"env":{"DOMENESHOP_API_TOKEN":"<your-api-token>","DOMENESHOP_API_SECRET":"<your-api-secret>"}}'

Codex CLI 从配置文件中的 mcp_servers 读取 MCP 服务：

[mcp_servers.domeneshop]
command = "npx"
args = ["-y", "domeneshop-mcp"]
env = { DOMENESHOP_API_TOKEN = "<your-api-token>", DOMENESHOP_API_SECRET = "<your-api-secret>" }

codex mcp add domeneshop -- npx -y domeneshop-mcp 会通过命令行注册服务，但不接受 env 标志，因此请在它创建的 [mcp_servers.domeneshop] 代码块中设置这两个变量。

Windsurf、Cline、Continue、LM Studio，以及任何可通过 stdio 运行 MCP 服务的程序都适用。大多数程序使用与上述标准配置相同的格式；请查阅客户端文档，确认配置文件和键名，然后将其指向：

• command：npx
• args：["-y", "domeneshop-mcp"]
• env：DOMENESHOP_API_TOKEN 和 DOMENESHOP_API_SECRET

若要避免每次启动时都解析软件包，请先安装一次，然后将 domeneshop-mcp 用作不带参数的命令。使用 npm：

npm install -g domeneshop-mcp

或者，在 macOS 或 Linux 上使用 Homebrew；如果尚未安装 Node.js，它也会为你安装：

brew install martinzachariassen/tap/domeneshop-mcp

brew upgrade domeneshop-mcp 可获取新版本。Claude Desktop 等 GUI 应用通常无法看到 Homebrew 的 PATH，因此请提供完整路径（brew --prefix 会打印前缀：Apple 芯片 Mac 上为 /opt/homebrew，Intel Mac 上为 /usr/local，Linux 上为 /home/linuxbrew/.linuxbrew）：

{
  "mcpServers": {
    "domeneshop": {
      "command": "/opt/homebrew/bin/domeneshop-mcp",
      "env": {
        "DOMENESHOP_API_TOKEN": "<your-api-token>",
        "DOMENESHOP_API_SECRET": "<your-api-secret>"
      }
    }
  }
}

Domeneshop 支持的 11 种记录类型均已支持，并包含各类型专属字段：

tag 字段有意不指定类型：对于 DS，它是数字密钥标签；对于 CAA，它是 issue 这类属性标签，而 Domeneshop 对两者都未作说明。

此服务依赖的部分行为未包含在 Domeneshop 发布的 OpenAPI 规范中，但已得到支持，并由其自有客户端库使用：

• 规范记录了 7 种记录类型；从 domeneshop.js 和 python-domeneshop 中的记录验证可以看出，ANAME、CAA、DS 和 NS 也可用。
• GET /invoices 接受 status 筛选条件，domeneshop.js 会使用该条件。
• POST /forwards/ 返回 201 和空响应体，并且只在 Location 标头中提供新转发项的名称。
• GET /dyndns/update 返回 204 且没有响应体，而不是 JSON，因此客户端不会尝试解码响应。

• npm 包
• Homebrew tap
• MCP Registry
• Claude Desktop 安装包（每个版本均附带 .mcpb）

src/
  domeneshop/       Domeneshop API client (HTTP transport + one resource per endpoint group)
  mcp/              MCP server: tool registration, schemas, result/error helpers
  index.ts          CLI entry point
test/
  domeneshop/       Client tests, against a local HTTP server
  mcp/              End-to-end tool tests, against an in-memory MCP transport