DNSPod MCP on Cloudflare Workers

把 腾讯云 DNSPod 变成可在线访问的 MCP（Model Context Protocol） 服务，跑在 Cloudflare Workers 上。

一条 Worker 同时提供：

• Streamable HTTP / SSE MCP 端点（给 Grok、Claude、Cursor 等远程连接）

• OAuth 2.1 + PKCE 授权（动态客户端注册、登录页、JWT Access Token）

• 调用 DNSPod OpenAPI（域名 / 记录 / 解析量统计）

官方 mcp-server-dnspod 只支持本地 stdio。本项目把它变成 公网 HTTPS MCP，适合 Grok Connectors 等网页端。

为什么需要它？

架构

Grok / Claude / Cursor
        │  HTTPS  MCP Streamable HTTP
        ▼
Cloudflare Worker  (dnspod-mcp)
  ├── /.well-known/oauth-authorization-server
  ├── /register          动态客户端注册
  ├── /authorize         登录页（OAUTH_PASSWORD）
  ├── /token             code + PKCE → JWT
  └── /mcp               需 Bearer access_token
            │
            │  TC3-HMAC-SHA256
            ▼
     DNSPod OpenAPI (dnspod.tencentcloudapi.com)

功能 / Tools

与官方 mcp-server-dnspod 对比：覆盖其主要查询能力，并额外支持记录增删改；官方的线路查询接口（DescribeRecordLineList 等）尚未接入。

快速部署

1. 准备

• Cloudflare 账号

• 腾讯云 API 密钥（SecretId / SecretKey）

• Node.js ≥ 18

2. 克隆 & 安装

git clone https://github.com/zfx-t/dnspod-mcp-workers.git
cd dnspod-mcp-workers
npm install

3. 创建 KV（OAuth 存储）

npx wrangler kv namespace create dnspod-mcp-oauth

把返回的 id 填进 wrangler.toml 的 [[kv_namespaces]]。

4. 配置 Secrets

npx wrangler secret put TENCENTCLOUD_SECRET_ID
npx wrangler secret put TENCENTCLOUD_SECRET_KEY
npx wrangler secret put OAUTH_PASSWORD          # 授权页访问密码
npx wrangler secret put OAUTH_JWT_SECRET        # 随机长字符串

可选：TENCENTCLOUD_REGION（默认 ap-guangzhou，已在 wrangler.toml vars）。

5. 部署

npx wrangler deploy

得到类似：

https://dnspod-mcp.<your-subdomain>.workers.dev

自定义域名（可选）：

# 在 Cloudflare Dashboard → Workers → dnspod-mcp → Triggers → Custom Domains
# 或使用 wrangler domains / 路由绑定

6. 本地开发

cp .env.example .dev.vars   # 填入真实密钥（勿提交）
npx wrangler dev

接入 Grok Connectors

1. 打开 Grok → Connectors → Custom

2. URL 只填：

https://<your-worker-host>/mcp

3. 保存后触发连接 → 浏览器打开授权页

4. 输入 OAUTH_PASSWORD → 授权

5. 回到 Grok，即可调用 DNS 工具

Grok 不支持手填 Bearer 时，本项目的 OAuth 弹窗就是为此设计的。

其它客户端

任何支持 Remote MCP + OAuth 2.1（PKCE） 的客户端都可连接同一 URL。

手动调试：

# 元数据
curl https://<host>/.well-known/oauth-authorization-server

# 未授权应 401 + WWW-Authenticate
curl -i -X POST https://<host>/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

HTTP 路由一览

安全说明

• 腾讯云密钥 只存在 Cloudflare Secrets，不会出现在客户端配置里

• OAuth 访问密码 仅在浏览器授权页输入，不写进 Connector

• Access Token 默认 1 小时，Refresh Token 30 天

• 建议：生产环境使用强随机 OAUTH_PASSWORD / OAUTH_JWT_SECRET，并限制腾讯云子账号仅 DNSPod 权限

• 不要 把 .dev.vars、真实 Secret 提交到 Git

与官方 DNSPod MCP 的关系

• 官方包：pip install mcp-server-dnspod（stdio，适合 Claude Desktop 本地）

• 本仓库：Cloudflare Workers 远程 MCP，OAuth 网关 + 部分写操作增强

• API 签名：TC3-HMAC-SHA256，与腾讯云 OpenAPI 一致

开发

单文件 Worker，无运行时依赖：

src/index.js      # MCP + OAuth + DNSPod 客户端
wrangler.toml     # 部署配置

欢迎 PR：补齐线路查询工具、支持更多 DNSPod API、接入 Cloudflare Access 等。

License

MIT

致谢

• Model Context Protocol

• Tencent Cloud DNSPod API

• Cloudflare Workers

• 官方 mcp-server-dnspod