Whodis MCP Server

🚀 Whois MCP サーバー

このプロジェクトは、WHOIS クエリを通じてドメインの可用性をチェックするためのモデルコンテキストプロトコル（MCP）サーバーを提供します。AI アシスタントやその他のツールが、ドメイン可用性チェックをワークフローに統合できるようになります。

🚀 クイックスタート

このサーバーは、MCP 標準を実装し、ドメインの可用性情報を提供します。AI システムが安全かつコンテキストを持って外部ツールやデータソースに接続できるようにします。

✨ 主な機能

概要

何がMCPですか？

モデルコンテキストプロトコル（MCP）は、AIシステムが外部のツールやデータソースに安全かつコンテキストを持って接続できるようにするオープン標準です。このサーバーは、MCP標準を実装してドメインの可用性情報を提供します。

機能

• ドメイン可用性チェック：whoiser ライブラリを使用して WHOIS クエリを実行し、ドメインが利用可能か登録済みかを判断します。
• MCP ツール統合：MCP クライアント（AIアシスタントなど）が使用できる check-domain-availability ツールを公開します。
• CLI インターフェイス：直接使用およびテストするためのコマンドラインインターフェイス (whodis-mcp-server check-domain-availability ...) を備えています。
• 構造化ログ記録：デバッグと監視のための詳細なログ記録を提供します。
• 設定可能：環境変数または .env ファイルを通じた設定をサポートします。

📦 インストール

前提条件

• Node.js (>=18.x)：ダウンロード
• Git：バージョン管理に使用

ステップ1：クローンとインストール

# リポジトリをクローン
git clone https://github.com/vinsidious/whodis-mcp-server.git
cd whodis-mcp-server

# 依存関係をインストール
npm install

ステップ2：サーバーを起動

# 開発モードで起動
npm run dev

# 本番モードで起動
npm start

📚 ドキュメント

機能概要

MCP サービス

• ドメイン可用性チェック：WHOIS クエリを通じて指定されたドメインの登録状態をチェックします。
• 登録情報の取得：登録済みドメインの詳細情報（登録業者、有効期限など）を抽出して表示します。

CLI ツール

• 対話モード：ユーザーがドメインを入力し、リアルタイムのフィードバックを得ることができます。
• バッチ処理：複数のドメインの可用性を一度にチェックすることができます。

プロジェクトアーキテクチャ

コアコンポーネント

• WHOIS クエリャ：WHOIS データの取得と解析を担当します。
• MCP インターフェイスアダプター：MCP プロトコルと互換性のある API エンドポイントを実装します。
• ログシステム：すべての操作を記録し、監査とトラブルシューティングに使用します。

コード構造

whodis-mcp-server/
├── src/                 # ソースコードディレクトリ
│   ├── whois.js         # WHOIS クエリの実装
│   ├── mcp-interface.js # MCP プロトコルアダプター
│   └── logger.js        # ログ記録モジュール
├── package.json          # 依存関係管理ファイル
└── .env.example           # 環境変数のサンプルファイル

開発ガイド

依存関係のインストール

npm install

テストの実行

npm test

デバッグログ

DEBUG=true npm start

設定

• 環境変数：

  export MCP_SERVER_PORT=3000
  export WHOIS_API_KEY=your_api_key
  

リリースフロー

1. 変更をコミットし、約束事に沿ったコミットメッセージ（例：feat:、fix:、chore:）を使用します。
2. 変更をメインブランチにプッシュします。
3. .github/workflows/ci-semantic-release.yml にあるワークフローが自動的にビルド、テスト、バージョン管理、npm リリースを実行します。

📄 ライセンス

ISC ライセンス