namecheap-api-mcp

namecheap-api-mcp

Namecheap API 用の MCP サーバーです。AI アシスタントから直接、ドメイン、DNS、連絡先、レジストラロックを管理し、SSL 証明書と料金を確認できます。

Claude Code および MCP 互換のあらゆる AI ツール向けに構築されています。

Rex Jones による The SEO Engine ツールキットの一部です。代理店や企業向けの AI 搭載 SEO・ソーシャルメディアツールです。

安全性モデル

このサーバーには、読み取りと安全な書き込みのツールのみが含まれています。アカウント情報の読み取りに加え、DNS／ネームサーバー／転送／ロックの設定を変更できます（すべて元に戻せます）。ただし、費用が発生する操作や取り消せない操作は意図的に含めていません。ドメイン登録、更新、再有効化、移管、SSL の購入／有効化、入金、アカウント／住所の変更はできません。必要に応じて、フォークして追加できます。

クイックスタート

1. Namecheap API アクセスを有効にする

1. Profile → Tools → Namecheap API Access に移動し、スイッチを ON にします。（本番環境へのアクセスには、アカウントの利用資格が必要です。ドメインが 20 個以上、残高が 50 ドル以上、または累計利用額が 50 ドル以上のいずれかを満たしてください。）
2. API キーをコピーします。
3. このサーバーを実行するマシンのパブリック IPv4 アドレスをホワイトリストに登録します（ホワイトリストにない IP からの API リクエストは、エラー 1011150 で拒否されます）。

2. MCP クライアントを設定する

{
  "mcpServers": {
    "namecheap": {
      "command": "npx",
      "args": ["-y", "namecheap-api-mcp"],
      "env": {
        "NAMECHEAP_API_USER": "your_username",
        "NAMECHEAP_API_KEY": "your_api_key",
        "NAMECHEAP_CLIENT_IP": "your.whitelisted.ip.v4"
      }
    }
  }
}

オプション：クローンしてビルドする

git clone https://github.com/lanternrow/namecheap-api-mcp.git
cd namecheap-api-mcp
npm install
npm run build

次に、クライアントの接続先を node /path/to/namecheap-api-mcp/dist/index.js に設定します。ローカルの認証情報を使う場合は、Git の管理対象外にした .env（.env.example をコピー）を用意して、Node のネイティブフラグを使って起動できます。node --env-file=.env dist/index.js。

環境変数

変数	必須	説明
NAMECHEAP_API_USER	はい	Namecheap アカウントのユーザー名（API ユーザー）。
NAMECHEAP_API_KEY	はい	Profile → Tools → API Access で取得した API キーです。秘密情報です。
NAMECHEAP_CLIENT_IP	はい	このマシンのホワイトリスト登録済みパブリック IPv4 アドレスです。
NAMECHEAP_USERNAME	いいえ	デフォルトは NAMECHEAP_API_USER です。リセラーのサブユーザーの場合のみ異なります。
NAMECHEAP_ENVIRONMENT	いいえ	production（デフォルト）または sandbox。

ツール

読み取り

ツール	説明
check_connection	認証情報と IP のホワイトリスト登録を確認し、アカウント残高の概要を返します。
list_domains	有効期限、ロック、自動更新、WhoisGuard の状態とともにドメインを一覧表示します（ページ分割／検索に対応）。
get_domain_info	1 つのドメインの詳細情報を取得します。
check_domains	ドメインの空き状況とプレミアム価格を確認します（一度に最大 50 件）。
get_domain_contacts	登録者／技術／管理者／AuxBilling の連絡先を取得します。
get_registrar_lock	レジストラロックの状態を取得します。
get_dns_hosts	ドメインのすべての DNS ホストレコードを取得します。
get_nameservers	ネームサーバーと、Namecheap DNS が使用中かどうかを取得します。
get_email_forwarding	メール転送ルールを取得します。
get_pricing	製品タイプごとの Namecheap 料金を取得します（結果をキャッシュしてください）。
list_ssl_certificates	種類、ホスト、状態、有効期限とともに SSL 証明書を一覧表示します。

安全な書き込み（設定のみ — 料金は発生しません）

ツール	説明
set_dns_hosts	すべてのホストレコードを置き換えます（破壊的操作です。省略したレコードは削除されるため、全レコードを送信してください）。
set_default_dns	ドメインを Namecheap のデフォルトネームサーバーに切り替えます。
set_custom_nameservers	ドメインをカスタムネームサーバーに向けます。
set_email_forwarding	メール転送ルールを設定します。
set_registrar_lock	レジストラでドメインをロック／ロック解除します。

注意点と落とし穴

• API の設計上、set_dns_hosts は破壊的な操作です。 Namecheap の setHosts は、呼び出しに含まれていないすべてのレコードを削除します。必ず最初に現在のレコードを取得し（get_dns_hosts）、変更を反映してから、レコード一式を送信してください。
• エラーが HTTP 200 で返されます。 Namecheap API は HTTP ステータスではなく、XML 本文の Status="ERROR" で失敗を通知します。このサーバーはそれを解析し、Namecheap のエラー番号とメッセージを含む実際のエラーをスローします。
• 許可リストに登録できるクライアント IP は IPv4 のみです。

セキュリティ

• 認証情報は環境変数からのみ読み込まれます。このサーバーが認証情報をハードコード、ログ記録、またはディスクへの書き込みを行うことはありません。
• API キーはクエリ文字列に含まれます（Namecheap の仕様）。このサーバーがリクエスト URL やキーをログに記録することはなく、エラーメッセージには Namecheap のエラー番号とテキストのみが表示されます。

ライセンス

MIT © Rex Jones