Whodis MCP サーバー

このプロジェクトは、WHOIS検索を用いてドメイン名の可用性を確認するために特別に設計されたModel Context Protocol（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: クローンとインストール

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

npm run dev:server実行します。
ブラウザでhttp://localhost:5173を開きます。
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 に更新を公開するには:

変更がコミットされていることを確認し、従来のコミットメッセージ (例: feat: 、 fix: 、 chore: ) に従います。
変更をmainブランチにプッシュします。
ci-semantic-release.ymlワークフローは、パッケージを自動的にビルド、テスト、バージョン管理し、npm に公開します。

ライセンス

ISCライセンス

This server cannot be installed

security - not tested

license - not found

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

AI アシスタントが WHOIS 検索を使用してドメイン名の可用性を確認できるようにするモデルコンテキストプロトコルサーバー。

Related MCP Servers

ServiceNow MCP Server
michaelbuckner
-
security
A
license
-
quality
A Model Context Protocol server enabling AI agents to access and manipulate ServiceNow data through natural language interactions, allowing users to search for records, update them, and manage scripts.
Last updated -
9
Python
MIT License
Whois MCP
bharathvaj-ganesan
A
security
A
license
A
quality
A Model Context Protocol server that allows AI agents to perform WHOIS lookups, enabling users to directly ask the AI about domain availability, ownership, registration details, and other domain information.
Last updated -
4
10
1
JavaScript
MIT License
Notion MCP Server
emmanuelsystems
-
security
F
license
-
quality
A Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.
Last updated -
275
JavaScript
Whois MCP
modelcontextprotocol-servers
-
security
F
license
-
quality
Enables AI agents to perform WHOIS lookups to retrieve domain registration details, including ownership, registration dates, and availability status without requiring browser searches.
Last updated -
2
2
JavaScript

View all related MCP servers

Whodis MCP Server