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: クローンとインストール

# Clone the repository
git clone https://github.com/vinsidious/whodis-mcp-server.git
cd whodis-mcp-server

# Install dependencies
npm install

ステップ2: 開発サーバーを実行する

MCP インスペクターを介してサーバーと対話するには、開発モードでサーバーを起動します。

npm run dev:server

これにより、MCP サーバーが起動し、 http://localhost:5173で MCP インスペクターが有効になり、 check-domain-availabilityツールをテストできるようになります。

ステップ3: CLI経由でツールをテストする

ドメイン可用性チェッカーをコマンドラインから直接実行します。

# Using CLI in development mode
npm run dev:cli -- check-domain-availability example.com non-existent-domain-12345.org

# Or run the built version
npm run start:cli -- check-domain-availability google.com my-unique-idea.dev

CLI は、 available配列とunavailable配列を含む JSON オブジェクトを出力します。

建築

このサーバーは階層型アーキテクチャに従います。

src/
├── cli/              # Command-line interface logic
├── controllers/      # Business logic for domain checks
├── services/         # Interaction with the whoiser library
├── tools/            # MCP tool definition and argument validation
├── types/            # Shared type definitions
├── utils/            # Shared utilities (logging, errors, etc.)
└── index.ts          # Main entry point for server and CLI

開発ガイド

開発スクリプト

# Start MCP server in development mode (with MCP Inspector)
npm run dev:server

# Run CLI commands in development mode
npm run dev:cli -- check-domain-availability <domains...>

# Build the project for production
npm run build

# Start MCP server in production mode (requires MCP client)
npm run start:server

# Run CLI commands using the production build
npm run start:cli -- check-domain-availability <domains...>

テスト

# Run all tests
npm test

# Generate test coverage report
npm run test:coverage

コード品質

# Lint code
npm run lint

# Format code with Prettier
npm run format

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 インスペクターにアクセスしてツールをテストし、リクエスト/レスポンスの詳細を表示します。

1. npm run dev:server実行します。

2. ブラウザでhttp://localhost:5173を開きます。

3. UI を使用して、 check-domain-availabilityツールを呼び出します。

サーバーログ

詳細な出力のためにデバッグ ログを有効にします。

# Set environment variable
DEBUG=true npm run dev:server

# Or set DEBUG=true in your .env file

ログは~/.mcp/data/whodis-mcp-server.*.log内のファイルにも保存されます。

出版

npm に更新を公開するには:

1. 変更がコミットされていることを確認し、従来のコミット メッセージ (例: feat: 、 fix: 、 chore: ) に従います。

2. 変更をmainブランチにプッシュします。

3. ci-semantic-release.ymlワークフローは、パッケージを自動的にビルド、テスト、バージョン管理し、npm に公開します。

ライセンス

ISCライセンス