Whodis MCP サーバー
このプロジェクトは、WHOIS検索を用いてドメイン名の可用性を確認するために特別に設計されたModel Context Protocol(MCP)サーバーを提供します。これにより、AIアシスタントやその他のツールがドメインの可用性確認をワークフローに統合できるようになります。
概要
MCPとは何ですか?
モデルコンテキストプロトコル(MCP)は、AIシステムが外部ツールやデータソースに安全かつコンテキストに基づいて接続できるようにするオープンスタンダードです。このサーバーは、ドメインの可用性情報を提供するためにMCP標準を実装しています。
Related MCP server: WebSearch-MCP
特徴
ドメインの可用性チェック:
whoiserライブラリを使用して WHOIS 検索を実行し、ドメインが利用可能または登録済みかどうかを判断します。MCP ツール統合: MCP クライアント (AI アシスタントなど) 用の
check-domain-availabilityツールを公開します。CLI インターフェイス: 直接使用およびテスト用のコマンド ライン インターフェイス (
whodis-mcp-server check-domain-availability ...) が含まれています。構造化ログ: デバッグと監視のための詳細なログを提供します。
構成可能: 環境変数または
.envファイルによる構成をサポートします。
はじめる
前提条件
Node.js (>=18.x):ダウンロード
Git : バージョン管理用
ステップ1: クローンとインストール
ステップ2: 開発サーバーを実行する
MCP インスペクターを介してサーバーと対話するには、開発モードでサーバーを起動します。
これにより、MCP サーバーが起動し、 http://localhost:5173で MCP インスペクターが有効になり、 check-domain-availabilityツールをテストできるようになります。
ステップ3: CLI経由でツールをテストする
ドメイン可用性チェッカーをコマンドラインから直接実行します。
CLI は、 available配列とunavailable配列を含む JSON オブジェクトを出力します。
建築
このサーバーは階層型アーキテクチャに従います。
開発ガイド
開発スクリプト
テスト
コード品質
MCP ツール: check-domain-availability
目的: 1 つ以上のドメイン名の可用性を確認します。
入力: ドメイン名の配列。
{ "domains": ["example.com", "another-domain.net"] }出力:
available(未登録のドメイン) とunavailable(登録済みのドメイン) の 2 つの配列を含む JSON オブジェクト。{ "available": ["likely-available-domain123.xyz"], "unavailable": ["google.com"] }注:ドメインの可用性チェックはWHOISサーバーの応答に依存しており、すべてのTLDについて100%の精度が得られない場合があります。また、一時的なネットワークの問題により、このチェックが不可能となる場合があります。検索に失敗したドメインは省略されます。
使用する場合: 特定のドメイン名が登録できる可能性があるかどうかを判断する必要がある場合にこのツールを使用します。
デバッグ
MCP検査官
ビジュアル MCP インスペクターにアクセスしてツールをテストし、リクエスト/レスポンスの詳細を表示します。
npm run dev:server実行します。ブラウザでhttp://localhost:5173を開きます。
UI を使用して、
check-domain-availabilityツールを呼び出します。
サーバーログ
詳細な出力のためにデバッグ ログを有効にします。
ログは~/.mcp/data/whodis-mcp-server.*.log内のファイルにも保存されます。
出版
npm に更新を公開するには:
変更がコミットされていることを確認し、従来のコミット メッセージ (例:
feat:、fix:、chore:) に従います。変更を
mainブランチにプッシュします。ci-semantic-release.ymlワークフローは、パッケージを自動的にビルド、テスト、バージョン管理し、npm に公開します。