Domain Checker MCP

Domain Checker MCP

WHOIS フォールバックを備え、RDAP（Registration Data Access Protocol）を使用してドメインの空き状況を確認する MCP（Model Context Protocol）サーバーです。

機能

• 単一ドメインの空き状況を確認
• 複数のドメインを並列で一括確認
• ドメイン検索には RDAP を優先して使用
• RDAP を利用できない場合は WHOIS にフォールバック
• 並列ワーカー数を設定可能（デフォルト：4）
• レート制限された応答に対する指数バックオフ付き再試行メカニズム
• ドメインのステータスを強化して検出（available、taken、unknown、rate_limited）
• ドメイン情報を抽出（レジストラ、有効期限、期限までの日数）
• 空き状況の判定精度を高めるため、null の登録データを検出
• 効率的な応答モード：応答を高速化するため、デフォルトでは生の RDAP／WHOIS データを除外

MCP の設定

npm パッケージを使用する場合

このサーバーを MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "domain-checker": {
      "command": "npx",
      "args": ["-y", "domain-checker-mcp"]
    }
  }
}

ローカルインストールを使用する場合

{
  "mcpServers": {
    "domain-checker": {
      "command": "node",
      "args": ["/path/to/domain-checker-mcp/dist/index.js"]
    }
  }
}

インストール

npm から

npm install -g domain-checker-mcp

ソースから

git clone https://github.com/yourusername/domain-checker-mcp.git
cd domain-checker-mcp
pnpm install
pnpm build

使用方法

MCP サーバーの実行

pnpm start

利用可能なツール

すべてのツールは、応答に生の RDAP／WHOIS データを含めるかどうかを制御するオプションの includeRawResponse パラメーター（ブール値、デフォルト：false）をサポートしています。疑わしいケース（ステータスが不明、レート制限、エラー）では、生の応答が自動的に含まれます。

1. check_domain - 単一ドメインの空き状況を確認

   • 入力：
     • domain (string) - 確認するドメイン名
     • includeRawResponse (boolean, optional) - 生の応答データを含める（デフォルト：false）

2. check_domains_batch - 複数のドメインを並列で確認

   • 入力：
     • domains (string[]) - 確認するドメイン名の配列
     • concurrency (number, optional) - 並列ワーカー数（1～10、デフォルト：4）
     • includeRawResponse (boolean, optional) - 生の応答データを含める（デフォルト：false）

3. check_name_extensions - 1 つの名前について複数の拡張子を確認

   • 入力：
     • name (string) - 拡張子を除いたドメイン名（例："example"）
     • extensions (string[]) - 確認する拡張子の配列（例：["com", "net", "org"]）
     • concurrency (number, optional) - 並列ワーカー数（1～10、デフォルト：4）
     • includeRawResponse (boolean, optional) - 生の応答データを含める（デフォルト：false）

4. check_names_extensions - 複数の名前について複数の拡張子を確認

   • 入力：
     • names (string[]) - 拡張子を除いたドメイン名の配列
     • extensions (string[]) - 各名前について確認する拡張子の配列
     • concurrency (number, optional) - 並列ワーカー数（1～10、デフォルト：4）
     • includeRawResponse (boolean, optional) - 生の応答データを含める（デフォルト：false）

応答形式

単一ドメインの確認結果：

{
  "domain": "example.com",
  "available": false,
  "status": "taken",
  "method": "rdap",
  "registrationData": { ... },
  "domainInfo": {
    "registrar": "Example Registrar Inc.",
    "expirationDate": "2025-12-31T23:59:59Z",
    "daysUntilExpiration": 365,
    "creationDate": "2020-01-01T00:00:00Z",
    "lastUpdated": "2024-01-15T12:00:00Z"
  }
}

一括確認の結果：

{
  "total": 5,
  "available": 2,
  "taken": 2,
  "errors": 0,
  "rateLimited": 1,
  "unknown": 0,
  "results": [...]
}

名前と拡張子の確認結果：

{
  "name": "example",
  "total": 3,
  "available": 1,
  "taken": 2,
  "errors": 0,
  "rateLimited": 0,
  "unknown": 0,
  "results": [...]
}

複数の名前と拡張子の確認結果：

{
  "totalNames": 2,
  "totalExtensions": 3,
  "totalChecks": 6,
  "availableTotal": 2,
  "takenTotal": 3,
  "errorsTotal": 0,
  "rateLimitedTotal": 1,
  "unknownTotal": 0,
  "resultsByName": {
    "example": {
      "total": 3,
      "available": 1,
      "taken": 2,
      "errors": 0,
      "rateLimited": 0,
      "unknown": 0,
      "domains": [...]
    },
    ...
  }
}

公開

新しいバージョンを公開するには：

1. package.json のバージョンを更新します
2. 変更をコミットします
3. 新しいタグを作成してプッシュします：

   git tag v0.1.0
   git push origin v0.1.0
   

4. GitHub Actions が自動的に npm に公開します

要件

• GitHub リポジトリの設定で NPM_TOKEN シークレットを設定します
• タグは 'v' で始まる必要があります（例：v0.1.0、v1.0.0）

ライセンス

MIT