mcpField
C
cloudflare-dns

cloudflare-dns

github.com/makerjackieCloud & DevOps146 installsUpdated 36w ago
Repository

About cloudflare-dns

A Cloudflare DNS operations skill for checking, creating, and updating DNS records, with verification steps and safeguards for API credentials. It is intended for users managing domain records and Pages domain bindings.

Key features

  1. 01Check records before changes
  2. 02Create or update DNS records
  3. 03Verify DNS and HTTP responses
  4. 04Check Pages domain status
  5. 05Use least-privilege token scopes

Use cases

  1. 01Updating a domain's DNS record
  2. 02Binding a custom domain to Pages
  3. 03Diagnosing DNS or authorization errors

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/makerjackie/jackie-skills-starter --skill cloudflare-dns

After installing, type/cloudflare-dnsin Claude Code to confirm it loaded.

Details

From the project README

Cloudflare DNS

Quick Start

  1. Clarify target:
    • domain/host (skills.01mvp.com)
    • record type (A/AAAA/CNAME/TXT)
    • target value
    • proxied on/off
  2. Run an auth precheck before any write action.
  3. Execute idempotent change (query existing record first, then create/update).
  4. Verify with DNS lookup + HTTP check + (if needed) Pages domain status.

First-Use Auth Gate (Required)

Before first DNS write, check token:

zsh -lic 'echo ${CLOUDFLARE_API_TOKEN:+SET}'

If empty, stop and prompt user to configure token first.

Use this prompt style:

  • 我先帮你配置，但需要你先提供 Cloudflare API Token（不是 wrangler OAuth）。
  • Token 最少权限：
    • Zone -> DNS -> Edit
    • Zone -> Zone -> Read
    • 如果要查 Pages 域名状态，再加：Account -> Cloudflare Pages -> Edit
  • Zone Resources 只选目标域名（最小权限原则）。
  • 配置完成后执行：
export CLOUDFLARE_API_TOKEN='YOUR_TOKEN'

Optional persistent setup:

echo "export CLOUDFLARE_API_TOKEN='YOUR_TOKEN'" >> ~/.zshrc
source ~/.zshrc

Standard Execution Pattern

1) Read current DNS record
python - <<'PY'
import json, os, urllib.request

token = os.environ['CLOUDFLARE_API_TOKEN']
zone_id = '<ZONE_ID>'
name = 'skills.01mvp.com'
url = f'https://api.cloudflare.com/client/v4/zones/{zone_id}/dns_records?name={name}'
req = urllib.request.Request(url, headers={'Authorization': f'Bearer {token}'})
print(json.dumps(json.load(urllib.request.urlopen(req)), ensure_ascii=False, indent=2))
PY
2) Create/Update record
  • If record not found: create.
  • If record exists but value/proxy mismatch: update.
  • If already correct: report "no-op".
3) Pages custom domain binding (if required)
  • Ensure domain is added to the Pages project.
  • If not added, create binding first, then ensure DNS points to <project>.pages.dev.
4) Verification
dig +short CNAME skills.01mvp.com
dig +short skills.01mvp.com
curl -I https://skills.01mvp.com

For Pages validation, also check domain status via Pages API/wrangler.

Safety Rules

  • Always query before write (no blind overwrite).
  • Prefer least-privilege token scope.
  • Never print full token in output.
  • Report exact record changed: name, type, content, proxied, timestamp.
  • If API returns auth error, explicitly tell user missing scope instead of retrying blindly.

Comments

Markdown supported