OnlyDNS MCP Server

OnlyDNS MCP サーバー（@onlydns/mcp）

OnlyDNS の公式 Model Context Protocol（MCP）サーバーです。公式 TypeScript SDK（@onlydns/sdk）を基盤として構築されています。Claude Desktop、Cursor、Junie、Windsurf、Claude Code などの AI エージェントが、OnlyDNS アカウントを使って DNS ゾーン、DNS レコード、DNSSEC 設定、TSIG キーを直接確認・管理できます。

---

機能

• 🌐 ドメイン管理：管理対象のドメインをすべて一覧表示し、新しい DNS ゾーンを作成します。
• 📝 DNS レコードの操作：
  • list_records：タイプ（A、AAAA、CNAME、MX、TXT、SRV、CAA など）またはホスト名で任意に絞り込んで、DNS レコードを照会します。
  • add_record：新しいレコードを作成するか、既存のレコードセットに値を追加します。ドメインは自動的に正規化されます。
  • update_record：既存の DNS レコードを変更し、TTL を更新します。
  • delete_record：特定のレコード値またはレコードセット全体を削除します。
  • set_records：ゾーンのレコードセット全体を一括で置き換えます。
• 🔐 DNSSEC 管理：DNSSEC の状態を確認し、DS/DNSKEY レコードを取得して、DNSSEC 署名を有効化または無効化します。
• 🔑 TSIG キー：セカンダリ DNS ゾーン転送（AXFR）および RFC 2136 の動的更新用の TSIG キーを生成・管理します。

---

インストールとクイックスタート

1. ワンクリックでデスクトップにインストール（MCPB バンドル）

GitHub Releases ページから onlydns-mcp.mcpb を直接ダウンロードします。対応するデスクトップクライアント（Claude Desktop など）では、ワンクリックでインストールでき、安全な設定ダイアログから ONLYDNS_API_TOKEN を設定できます。

2. npx を使用（インストール不要）

npx を使ってサーバーを直接実行できます。

export ONLYDNS_API_TOKEN="your_onlydns_api_token"
npx -y @onlydns/mcp

3. グローバルインストール

npm install -g @onlydns/mcp

---

設定

サーバーには OnlyDNS API Bearer Token が必要です。

環境変数

変数	説明	デフォルト
ONLYDNS_API_TOKEN	OnlyDNS API Bearer Token（必須）	-
ONLYDNS_API_BASE_URL	OnlyDNS REST API のベース URL	https://api.onlydns.com/v1

---

クライアント連携の例

Claude Desktop

以下を claude_desktop_config.json に追加します。

macOS：~/Library/Application Support/Claude/claude_desktop_config.json

Windows：%APPDATA%\Claude\claude_desktop_config.json

Linux：~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "onlydns": {
      "command": "npx",
      "args": ["-y", "@onlydns/mcp"],
      "env": {
        "ONLYDNS_API_TOKEN": "YOUR_ONLYDNS_BEARER_TOKEN"
      }
    }
  }
}

---

Cursor（または Windsurf / Claude Code）

MCP の設定または .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "onlydns": {
      "command": "npx",
      "args": ["-y", "@onlydns/mcp"],
      "env": {
        "ONLYDNS_API_TOKEN": "YOUR_ONLYDNS_BEARER_TOKEN"
      }
    }
  }
}

---

利用可能な MCP ツール

🌐 ドメイン

• list_domains(limit?, offset?)：アカウント内のすべてのドメインを一覧表示します。
• create_domain(domainName)：ドメインの新しい DNS ゾーンを作成します。

📝 DNS レコード

• list_records(domainName, type?, name?)：任意の条件で絞り込んで、ドメインの DNS レコードを一覧表示します。
• add_record(domainName, name, type, value, ttl?)：DNS レコード（例：A、CNAME、MX、TXT、URL、PROXY）を追加します。
• update_record(domainName, name, type, value, ttl?)：レコードタイプの値や TTL を置き換えます。
• delete_record(domainName, name, type, value?)：レコードまたは特定の値を削除します。
• set_records(domainName, records)：ゾーンの全レコードを一括で置き換えます。

🔐 DNSSEC

• get_dnssec(domainName)：DNSSEC の状態とキー（DS、DNSKEY）を取得します。
• enable_dnssec(domainName)：ゾーンの DNSSEC 署名を有効にします。
• disable_dnssec(domainName)：DNSSEC 署名を無効にします。

🔑 TSIG キー

• list_tsig_keys()：アカウントの TSIG キーをすべて一覧表示します。
• get_tsig_key(keyName)：TSIG キーの詳細を取得します。
• create_tsig_key(algorithm?)：新しい TSIG キー（hmac-sha256、hmac-sha512 など）を生成します。
• get_domain_tsig(domainName)：ドメインに設定されている TSIG キーと権限を取得します。
• configure_domain_tsig(domainName, keyName, allowAxfr, allowDnsUpdate, subdomains?)：ドメインの AXFR、DDNS、および任意のサブドメイン制限の権限を設定します。
• remove_domain_tsig(domainName)：ドメインからすべての TSIG キーを削除します。

---

開発とテスト

# Clone and install dependencies
git clone https://github.com/Onlydns/onlydns-mcp.git
cd onlydns-mcp
npm install

# Run unit tests
npm test

# Build TypeScript
npm run build

# Run locally in development
npm run dev

---

ライセンス

MIT © 2026 OnlyDNS