MCP Domain Availability

🚀 MCP Domain Availability Server

GoDaddy OTE APIを使用してドメインの可用性と価格を確認するためのModel Context Protocol (MCP)サーバーです。

🚀 クイックスタート

このサーバーは、GoDaddy OTE APIを利用してドメインの可用性と価格を確認するためのMCPサーバーです。以下の手順に従ってセットアップしてください。

✨ 主な機能

• GoDaddy OTEサンドボックスを介してドメインの可用性と価格を確認する
• 複数のTLDサフィックスをサポートする
• 高速チェックモードと完全チェックモードを提供する
• バルクドメインチェックをサポートする
• レート制限（1分間に60回の呼び出し）
• 価格をドルで2桁の小数で正規化する
• 一貫したフィールド名とデータ構造を持つ
• 期間を月単位で保存し、年単位で表示する

📦 インストール

uvを使用する（推奨）

# 依存関係をインストールする
uv add "mcp[cli]"

# テスト用にMCPインスペクターで実行する
DOMAIN_API_KEY="your-key:your-secret" mcp dev domain_availability/server.py

手動インストール

pip install -e .

📚 ドキュメント

環境変数

• DOMAIN_API_KEY: GoDaddy OTE APIの資格情報を "key:secret" の形式で指定します（必須）

注意: サーバーはデフォルトでGoDaddy OTE（サンドボックス）APIを使用します: https://api.ote-godaddy.com

GoDaddy OTEのセットアップ

1. GoDaddy Developerアカウントにサインアップします
2. OTE（サンドボックス）APIの資格情報を取得します
3. 環境変数を設定します: DOMAIN_API_KEY="your-ote-key:your-ote-secret"

MCPの設定

MCPクライアントの設定（例: Claude Desktopの claude_desktop_config.json）に以下を追加します:

{
  "mcpServers": {
    "domain-availability": {
      "command": "uv",
      "args": ["run", "mcp-domain-availability"],
      "env": {
        "DOMAIN_API_KEY": "your-ote-key:your-ote-secret"
      }
    }
  }
}

💻 使用例

開発とテスト

# テスト用にMCPインスペクターを起動する
DOMAIN_API_KEY="your-key:your-secret" mcp dev domain_availability/server.py

これにより、http://localhost:6274 でMCPインスペクターが起動し、対話的なテストができます。

利用可能なツール

サーバーは1つのツールを提供します: check_domain_availability

パラメータ

オプション1: 直接のドメインリスト

• domains: チェックするドメイン名の配列（例: ["example.com", "example.org"]）

オプション2: TLDサフィックス付きのベース名

• base_name: ベースのドメイン名（例: "example"）
• tld_suffixes: TLDサフィックスの配列（例: [".com", ".org", ".net", ".io"]）

オプション

• checkType: "FAST" または "FULL"（デフォルト: "FAST"）
  • FAST: 速度を最適化したモード
  • FULL: 精度を最適化したモード

例

特定のドメインをチェックする

{
  "domains": ["example.com", "example.org", "example.net"],
  "checkType": "FAST"
}

複数のTLDを持つベース名をチェックする

{
  "base_name": "myawesomesite",
  "tld_suffixes": [".com", ".org", ".net", ".io", ".dev", ".app"],
  "checkType": "FULL"
}

レスポンス形式

テキストレスポンス:

Domain Availability Check Results:

✅ AVAILABLE DOMAINS:
  • example.com - $12.99 USD for 1 year (Definitive)
  • example.org - $8.99 USD for 2 years (Preliminary)

❌ UNAVAILABLE DOMAINS:
  • example.net - Not available - Domain already registered

JSONレスポンス（正規化されたフィールド）:

{
  "domains": [
    {
      "domain_name": "example.com",
      "is_available": true,
      "price_dollars": 12.99,
      "currency_code": "USD",
      "is_definitive": true,
      "registration_period_months": 12
    },
    {
      "domain_name": "example.net",
      "is_available": false,
      "price_dollars": 0.00,
      "currency_code": "USD",
      "is_definitive": true,
      "registration_period_months": 12,
      "error_message": "Domain already registered"
    }
  ],
  "errors": []
}

🔧 技術詳細

価格の正規化

• 入力: GoDaddy APIは価格をマイクロ単位（通貨の1/1,000,000）で返します
• 出力: ドルで2桁の小数に変換されます
• 例: 12000000 マイクロ単位 → $12.00 USD

期間の正規化

• 保存: 期間は一貫性を保つために月単位で保存されます
• 表示: ユーザーに分かりやすいように年単位に変換されます
• 例: 12 months → "1 year", 24 months → "2 years"

フィールド名

一貫した、明示的なフィールド名を使用します:

• domain_name（domain の代わりに）
• is_available（available の代わりに）
• price_dollars（price の代わりに）
• currency_code（currency の代わりに）
• is_definitive（definitive の代わりに）
• registration_period_months（period の代わりに）
• error_message（error の代わりに）

API統合

このサーバーはGoDaddy OTE APIと統合されています:

• ベースURL: https://api.ote-godaddy.com
• エンドポイント: GET /v1/domains/available?domain={domain}
• ヘッダー: Authorization: sso-key {key}:{secret}
• レート制限: 1分間に60回のリクエスト

認証形式

Authorization: sso-key your-key:your-secret

エラーハンドリング

サーバーはさまざまなエラー条件を処理します:

• APIキーが不足している
• 無効なドメイン
• APIレート制限（429） - リトライガイダンス付き
• 部分的なレスポンス（203）
• 認証エラー（401, 403）
• サーバーエラー（500）
• ネットワークタイムアウト

開発

開発環境のセットアップ

# クローンしてセットアップする
git clone <repository>
cd mcp-free-domain
uv add "mcp[cli]"

# テストを実行する
pytest

# 開発サーバーを起動する
DOMAIN_API_KEY="test-key:test-secret" mcp dev domain_availability/server.py

MCPインスペクターでのテスト

1. OTEの資格情報を設定します: DOMAIN_API_KEY="your-key:your-secret"
2. 実行します: mcp dev domain_availability/server.py
3. ブラウザで http://localhost:6274 を開きます
4. 必要に応じて、ターミナルに表示されるセッショントークンを使用します
5. check_domain_availability ツールをテストします

📄 ライセンス

MIT License

サポート

問題や質問がある場合は、リポジトリにイシューを作成してください。