Whois MCP

🚀 WHOIS MCP サービス

このサービスは、モデルコンテキストプロトコル（MCP）に基づいて実装されたWHOISクエリサービスです。Javaアプリケーションとして、標準化されたインターフェースを通じてユーザーにドメイン名のWHOIS情報を提供します。サーバーは標準入出力で通信し、MCPクライアントと互換性があります。

🚀 クイックスタート

WHOIS MCPは、Model Context Protocolを通じてWHOISクエリ機能を提供するJavaアプリケーションです。ユーザーはこのサービスを使ってドメイン名のWHOIS情報をクエリし、標準化されたインターフェースを利用できます。サーバーは標準入出力通信をサポートし、MCPクライアントと互換性があります。

✨ 主な機能

1. ドメイン名の検証とクリーニング：クエリするドメイン名が有効であることを確認し、無効または誤った入力を処理します。
2. WHOISクエリ：Apache Commons Netライブラリを使用して、ドメインの登録情報をクエリします。
3. ログ記録：SLF4Jを使用して操作ログを記録し、デバッグとメンテナンスを容易にします。
4. モジュール化設計：各コンポーネントが独立しているため、拡張とメンテナンスが容易です。
5. テストカバレッジ：包括的な単体テストを提供し、コード品質を保証します。

📦 インストール

前提条件

• Java Development Kit (JDK) 8以上
• Apache Maven 3.6以上

ビルド手順

1. プロジェクトソースコードをダウンロードします：

   git clone https://github.com/your-repository.git
   cd whois-mcp
   

2. Mavenを使用してビルドします：

   mvn clean install
   

3. サーバーを起動します：

   java -jar target/whois-mcp.jar
   

📚 ドキュメント

デバッグガイド

MCP Inspectorツールを使用したデバッグ

1. MCP Inspectorをダウンロードしてインストールします。
2. ツールを開き、実行中のWHOIS MCPサービスに接続します。
3. ツールの界面を使用してクエリリクエストを送信し、応答結果を確認します。

使用方法

Claudeユーザー向け

以下の設定を settings.json ファイルに追加します：

{
  "whoisMcp": {
    "serverUrl": "http://localhost:8080",
    "apiKey": "your_api_key"
  }
}

VSCodeユーザー向け

ターミナルで以下のコマンドを実行してサービスを起動します：

cd whois-mcp
mvn spring-boot:run

プロジェクト構造

• Main Class: com.whoismcp.WhoIsMcpApplication - アプリケーションのメインエントリーポイント。
• Controllers: HTTPリクエストを処理し、WHOISクエリ結果を返します。
• Services: 実際のビジネスロジックを含み、ドメイン名の検証やWHOISクエリなどがあります。
• Utils: ログ記録や設定管理などの補助機能を提供します。

主要コンポーネント

1. WhoIsMcpApplication：アプリケーションの起動と設定を担当します。
2. DomainValidator：入力されたドメイン名が有効であることを確認します。
3. WhoIsClient：Apache Commons Netライブラリを使用してWHOISクエリを行います。
4. Logger：操作ログを記録し、デバッグを容易にします。

ワークフロー

1. ユーザーがドメイン名のクエリリクエストをサーバーに送信します。
2. サーバーがリクエストを受け取り、DomainValidator を呼び出して検証します。
3. 検証が通過したら、WhoIsClient を使用してWHOISクエリを実行します。
4. 返された結果を処理し、レスポンスとしてユーザーに返します。

Whoisサーバーマッピング

このプロジェクトは、IANAの根領域データベースに依存して、トップレベルドメインの情報を取得します。

依存関係

• Model Context Protocol (MCP)：MCPプロトコルを実装するために使用されます。
• SLF4J：ログ記録ライブラリで、デバッグとメンテナンスを容易にします。
• Apache Commons Net：WHOISクライアント機能を提供します。
• Apache Commons Validator：ドメイン名の検証に使用されます。
• JUnit Jupiter：単体テストフレームワークです。

テスト方法

以下のコマンドを実行して単体テストを実行します：

mvn test

デモ

• https://github.com/user-attachments/assets/037a30de-c330-4dd4-93c2-2add936b9caf
• https://github.com/user-attachments/assets/2a911111-xxxx-xxxx-xxxx-xxxxxxxxxx
• https://github.com/user-attachments/assets/3rd-party-link

📄 ライセンス

このプロジェクトはMITライセンスに従います。詳細はLICENSEファイルを参照してください。

作者情報

Jordi Ayala - asjordi.dev 連絡を取る場合は、彼の個人サイトを訪問して詳細を取得してください。