FastDomainCheck MCP Server

FastDomainCheck MCP サーバー

ドメイン名の登録状況を一括で確認するための Model Context Protocol 実装です。

関連リンク

• FastDomainCheck オンラインサービス - オンラインでドメインの登録状況を一括確認できます
• MCP サーバーのドキュメント - プロジェクトの詳細なドキュメントと技術仕様

概要

FastDomainCheck MCP Server は、AI ツール（Claude など）とドメインの空き状況データを安全に双方向接続する Model Context Protocol（MCP）サーバーの実装です。オープンな MCP 標準に準拠しているため、さまざまな AI 搭載アプリケーションとシームレスに互換性があります。

特長

• ドメインの登録状況を一括確認
• WHOIS と DNS を使用した二重検証
• IDN（国際化ドメイン名）に対応
• 簡潔な出力形式
• 入力検証とエラーハンドリングを内蔵

ツールのドキュメント

check_domains

複数のドメイン名の登録状況を確認します。

入力形式

{
  "domains": ["example.com", "test.com"]
}

パラメーター：

• domains：確認するドメイン名を含む文字列の配列
  • ドメインごとの最大文字数は255文字です
  • リクエストあたりのドメイン数は最大50件です
  • 空のドメイン名は指定できません

出力形式

{
  "results": {
    "example.com": {
      "registered": true
    },
    "test.com": {
      "registered": false
    }
  }
}

レスポンスフィールド：

• results：ドメイン名をキー、確認結果を値とするオブジェクト
  • registered：ブール値
    • true：ドメインは登録済みです
    • false：ドメインは取得可能です

エラーハンドリング

以下の場合、ツールはエラーを返します。

1. ドメインリストが空の場合
2. リクエストのドメイン数が50件を超える場合
3. ドメイン名が空の場合
4. ドメイン名が255文字を超える場合
5. 結果のシリアライズに失敗した場合

エラーレスポンス形式：

{
  "error": "Error: domains list cannot be empty"
}

使用例

複数のドメインを確認する場合：

リクエスト

{
  "domains": ["example.com", "test123456.com"]
}

レスポンス

{
  "results": {
    "example.com": {
      "registered": true
    },
    "test123456.com": {
      "registered": false
    }
  }
}

パフォーマンスに関する考慮事項

1. ドメインの確認は順番に実行され、1ドメインあたり約0.3～1秒かかります
2. リソースの枯渇を防ぐため、リクエストあたりのドメイン数は最大50件です
3. WHOIS クエリのタイムアウトは10秒に設定されています
4. WHOIS クエリに失敗した場合は、DNS クエリにフォールバックします

エラーハンドリング戦略

1. 入力検証：処理前に包括的な検証を行います
2. 二重検証：WHOIS を優先し、DNS にフォールバックします
3. タイムアウト管理：すべてのネットワーク処理に適切なタイムアウトを設定します
4. 詳細なエラーメッセージ：トラブルシューティングに役立つ明確なエラーの説明を提供します

使用方法

バイナリのダウンロード

リリースページからバイナリファイルをダウンロードしてください。 https://github.com/bingal/FastDomainCheck-MCP-Server/releases

Mac/Linux の場合

chmod +x FastDomainCheck-MCP-Server

MCP サーバーの設定

Claude Deskto での FastDomainCheck MCP の設定

以下のように claude-desktop-config.json ファイルを変更してください

Mac/Linux

{
  "mcpServers": {
    "fastdomaincheck": {
      "command": "/path/to/FastDomainCheck-MCP-Server",
      "args": []
    }
  }
}

Windows

{
  "mcpServers": {
    "fastdomaincheck": {
      "command": "path/to/FastDomainCheck-MCP-Server.exe",
      "args": []
    }
  }
}

Python 版

このプロジェクトの Python 版は fastdomaincheck-mcp-server で利用できます。

MCP サーバーの設定

{
  "mcpServers": {
    "fastdomaincheck": {
      "command": "uvx",
      "args": [
        "fastdomaincheck-mcp-server"
      ]
    }
  }
}

開発ガイド

要件

• Go 1.16 以降
• ネットワーク接続（WHOIS および DNS クエリ用）
• 依存関係：
  • github.com/metoro-io/mcp-golang
  • その他、プロジェクト固有の依存関係

ビルド

# Linux
go build -o FastDomainCheck-MCP-Server

# Windows
go build -o FastDomainCheck-MCP-Server.exe