Custom Domain API

本地服务

customdomainapi.com云与基础设施192 周前更新

代码仓库访问官网

关于 Custom Domain API

Custom Domain API 的 MCP 服务面向管理 SaaS 客户自定义域名的应用，可注册主机名、查看 DNS 记录与检查状态，并提供客户设置页面链接。它以应用 API 密钥操作，不提供操作员级操作。

主要功能

01注册客户主机名并返回 DNS 记录
02查看域名状态、记录和检查结果
03按工作区或状态分页列出域名
04生成 DNS 设置说明和指南
05创建或撤销设置页面链接
06重新检查或删除域名

适用场景

01为客户工作区注册自定义域名
02排查域名尚未生效的原因
03将域名设置说明交给客户
04DNS 修复后重新运行检查

MCP 相关

该 MCP 服务向 MCP 客户端提供域名注册、查询、DNS 指引、设置链接、重新检查和删除等工具。它使用应用 API 密钥，并不持有操作员令牌。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "sireto-custom-domain": {
      "command": "uvx",
      "args": [
        "custom-domain-mcp"
      ],
      "env": {
        "CUSTOM_DOMAIN_API_URL": "<CUSTOM_DOMAIN_API_URL>",
        "CUSTOM_DOMAIN_API_KEY": "<CUSTOM_DOMAIN_API_KEY>"
      }
    }
  }
}

启动命令uvx custom-domain-mcp

需要配置的环境变量

CUSTOM_DOMAIN_API_URLYour edge, such as https://edge.example.net (https only)

CUSTOM_DOMAIN_API_KEY密钥An application API key (cd_...), never an operator token

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypicustom-domain-mcp0.13.0stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

custom-domain-mcp

一个用于 Custom Domain API 的 MCP 服务。它允许 AI 助手（Claude、Cursor 和任何 MCP 客户端）注册客户的主机名、向他们显示 DNS 记录或设置页面链接、检查域名尚未上线的原因，并重新检查或删除域名。它作为一个应用运行，并使用该应用自己的 API 密钥。

设置

uvx custom-domain-mcp        # or: pip install custom-domain-mcp

它会从环境中读取两个设置：

设置	值
`CUSTOM_DOMAIN_API_URL`	你的边缘节点，例如 `https://edge.example.net`（仅支持 https；普通 http 仅用于 `localhost`）
`CUSTOM_DOMAIN_API_KEY`	应用 API 密钥（`cd_…`）

Claude Code：

claude mcp add custom-domain --env CUSTOM_DOMAIN_API_URL=https://edge.example.net \
  --env CUSTOM_DOMAIN_API_KEY=cd_... -- uvx custom-domain-mcp

Claude Desktop、Cursor 和其他客户端（在其配置中的 mcpServers）：

{
  "mcpServers": {
    "custom-domain": {
      "command": "uvx",
      "args": ["custom-domain-mcp"],
      "env": {
        "CUSTOM_DOMAIN_API_URL": "https://edge.example.net",
        "CUSTOM_DOMAIN_API_KEY": "cd_..."
      }
    }
  }
}

工具

工具	功能
`create_domain`	为工作区注册客户的主机名；返回其 DNS 记录。可以安全重试。
`get_domain`	获取域名及其状态、记录和四项检查。
`list_domains`	分页列出域名，可按工作区或状态筛选。
`dns_instructions`	以文本形式向客户提供记录、每条记录的说明以及检测到的 DNS 服务商指南。
`create_connect_session`	为一个域名生成设置页面链接（包含记录、上线检查，以及服务商支持时的一步设置），并提供过期时间。
`revoke_connect_session`	立即终止设置页面链接（标记为破坏性操作）。
`recheck_domain`	DNS 修复后重新运行检查（每个域名每分钟一次）。
`delete_domain`	停止为主机名提供服务并将其删除（标记为破坏性操作）。
`list_webhooks`	列出 Webhook 订阅，不含密钥。

它无法执行的操作

无法执行运营人员操作。 它不会持有运营人员令牌，只持有应用密钥，因此只能执行该应用后端能够执行的操作。
无法创建或轮换 Webhook。 Webhook 的响应包含签名密钥，这会出现在助手的对话中。请通过 API 或门户创建 Webhook。

设置页面链接是一个针对单个域名的凭证。 持有该链接的人可以查看该域名的设置和状态、请求检查并启动一步设置；不能执行其他操作，也永远无法获取 API 密钥。服务器会告知助手，只将链接交给拥有该主机名的客户。部署必须提供该页面（PUBLIC_API=true 和 EDGE_HOSTNAME）；否则，create_connect_session 会返回 connect_page_unavailable。

客户数据是数据，不是指令。 主机名、工作区引用、元数据和检查消息均来自应用的客户和 DNS。服务器会告知助手报告这些内容，但绝不遵循其中的指令；只有在你明确要求删除该域名时，才调用 delete_domain，并且必须先向你复述主机名。服务器还会告知助手，只有在你提出要求时才能创建设置页面链接，并且只能将链接交给你，绝不能发送到域名数据中找到的地址、URL 或频道：元数据由客户控制，不得用于引导凭证的发送位置。MCP 客户端对破坏性工具的确认机制可提供第二道检查。

服务器的指令还会告知助手集成代码必须遵循的一条规则：通过已验证的 X-Custom-Domain-Assertion 选择租户，绝不能通过 Host 选择（验证请求）。

支持 Markdown

登录后评论