Whoisfreaks

Name: Whoisfreaks
Author: WhoisFreaks

ローカル

github.com/WhoisFreaks開発ツール05 週間前に更新

リポジトリ

Whoisfreaks について

Whoisfreaksは、ドメイン、DNS、IP、SSL情報を扱うWhoisFreaks APIをMCPツールとして公開します。Dockerでの実行とソースからのビルドに対応し、stdioまたはHTTP/SSEで接続できます。

主な機能

01リアルタイムおよび履歴WHOIS検索
02DNSレコードと履歴の検索
03IP・ASN・位置情報の検索
04IPセキュリティ情報の照会
05ドメイン発見・空き状況・サブドメイン検索
06SSL/TLS証明書の詳細確認

活用シーン

01ドメイン登録情報と所有履歴の確認
02DNSレコードの調査や逆引きドメインの検索
03IPの位置情報やVPN・プロキシ・脅威情報の確認
04サブドメインの列挙とSSL証明書の確認

MCP 対応

stdioまたはHTTP/SSE経由で、WhoisFreaks APIのツールをMCPクライアントに提供します。Dockerイメージで実行するか、ソースからビルドできます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "whoisfreaks": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "WHOISFREAKS_API_KEY",
        "java"
      ],
      "env": {
        "WHOISFREAKS_API_KEY": "<WHOISFREAKS_API_KEY>"
      }
    }
  }
}

起動コマンドdocker run -i --rm -e WHOISFREAKS_API_KEY java

設定が必要な環境変数

WHOISFREAKS_API_KEYシークレット

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

ocijavastdio

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

WhoisFreaks MCP Server

**Model Context Protocol（MCP）**サーバーです。WhoisFreaks APIスイート全体を、AI から呼び出せるツールとして提供します。Claude Desktop、Cursor、Windsurf、VS Code、Continue、Zed、その他あらゆる MCP 対応 AI クライアントで動作します。

実行方法は 2 つあります。環境に合った方法を選んでください。

	方法	必要なもの	おすすめの用途
⭐ 推奨	Docker（ビルド済みイメージ）	Docker のみ	すべてのユーザー — Java や Maven は不要です
	ソースからビルド	Java 17 + Maven	コントリビューター／カスタムビルド

起動後は、stdio（ローカル）またはポート 3100 の HTTP/SSE（リモート VM）経由で、あらゆる MCP クライアントに接続できます。

ツールリファレンス

WHOIS ツール

ツール	説明
`liveWhoisLookup`	任意のドメインのリアルタイム WHOIS データ — レジストラ、登録者、日付、ネームサーバー
`whoisHistory`	ドメインの完全な所有者履歴
`reverseWhoisLookup`	メールアドレス、キーワード、所有者名、または企業名から、登録されたすべてのドメインを検索します

IP および ASN の WHOIS ツール

ツール	説明
`ipWhoisLookup`	任意の IPv4 または IPv6 アドレスの WHOIS 登録データ
`asnWhoisLookup`	自律システム番号（例：AS15169）の WHOIS データ

DNS ツール

ツール	説明
`dnsLookup`	ライブ DNS レコード — A、AAAA、MX、NS、CNAME、SOA、TXT、SPF、またはすべて
`dnsHistory`	変更履歴全体を含む過去の DNS レコード
`reverseDnsLookup`	指定した IP またはネームサーバーを参照するすべてのドメインを検索します

IP インテリジェンスツール

ツール	説明
`ipGeolocation`	任意の IP アドレスの国、都市、地域、ISP、座標
`ipSecurity`	任意の IP の VPN、プロキシ、Tor 出口ノード、ボット、および脅威インテリジェンス

ドメインツール

ツール	説明
`domainAvailability`	ドメインの登録可否を確認します。候補の提案も指定できます
`subdomainLookup`	ステータスと日付で絞り込み、ドメインの既知のサブドメインをすべて列挙します
`domainDiscovery`	タイポスクワッティングや類似のバリエーションを含め、キーワードからドメインを検索します

SSL ツール

ツール	説明
`sslLookup`	SSL/TLS 証明書の詳細 — 発行者、有効期限、SAN、チェーン、生データ

クイックスタート

⭐ 推奨 — Docker

Java や Maven は不要です。Docker Hub からビルド済みイメージを直接取得して実行します。

まず無料の API キーを取得してください： whoisfreaks.com/signup

オプション 1 — 直接 `docker run`（最も簡単）

docker run -d \
  --name whoisfreaks-mcp \
  --restart unless-stopped \
  -p 3100:3100 \
  -e WHOISFREAKS_API_KEY=your-api-key-here \
  whoisfreaks/mcp-server:latest

MCP ゲートウェイが http://localhost:3100/sse で利用できるようになりました。

オプション 2 — Docker Compose（本番環境／VM での使用に推奨）

docker-compose.yml を作成します。

services:
  whoisfreaks-mcp:
    image: whoisfreaks/mcp-server:latest
    container_name: whoisfreaks-mcp
    restart: unless-stopped
    ports:
      - "3100:3100"
    environment:
      WHOISFREAKS_API_KEY: your-api-key-here

起動します。

docker compose up -d

または、キーを直接記述する代わりに .env ファイルを使用します（推奨）。

# Create .env file (never commit this to git)
echo "WHOISFREAKS_API_KEY=your-api-key-here" > .env
docker compose up -d

Docker が動作していることを確認する

# Container should show as "Up"
docker ps

# SSE endpoint should respond
curl http://localhost:3100/health
# → {"status":"ok"}

# List all 14 registered tools
curl http://localhost:3100/tools/list

Claude Desktop で使用する（Docker の stdio モード）

Claude Desktop には stdio トランスポートが必要です。Docker のエントリーポイントを上書きし、mcp-proxy を介さずに JAR を直接実行します。

{
  "mcpServers": {
    "whoisfreaks": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "WHOISFREAKS_API_KEY=your-api-key-here",
        "--entrypoint", "java",
        "whoisfreaks/mcp-server:latest",
        "-jar", "app.jar"
      ]
    }
  }
}

ここではポートマッピングは不要です。Claude Desktop は stdio 経由でコンテナと直接通信します。

ソースからビルド

コードを変更する場合、またはカスタムバージョンをビルドする場合にのみ必要です。

前提条件：

要件	最小バージョン	備考
Java（JDK）	17	`java -version` で確認できます
Maven	3.8	`mvn -version` で確認できます
WhoisFreaks API Key	—	whoisfreaks.com/signup から取得できます

クローンしてビルドする：

git clone https://github.com/whoisfreaks/whoisfreaks-mcp-server.git
cd whoisfreaks-mcp-server
mvn clean package -q

これにより、単体で実行できる単一のファット JAR が生成されます：

target/whoisfreaks-mcp-server-1.0.0.jar

ヒント： この JAR の絶対パスを控えておいてください。以下のプラットフォーム設定で必要になります。例：/Users/yourname/whoisfreaks-mcp-server/target/whoisfreaks-mcp-server-1.0.0.jar

前提条件

要件	備考
Docker	推奨される Docker の方法で必要です
Java 17 + Maven 3.8	ソースからビルドする場合にのみ必要です
WhoisFreaks API Key	whoisfreaks.com/signup から無料で取得できます

プラットフォームとの連携

1. Claude Desktop

最も広く使われている MCP クライアントです。Claude Desktop は起動時に MCP サーバーをサブプロセスとして起動し、stdio 経由で通信します。SSE/HTTP URL には対応していません。

設定ファイルの場所：

OS	パス
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

⭐ オプション A — Docker（推奨、Java 不要）

{
  "mcpServers": {
    "whoisfreaks": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "WHOISFREAKS_API_KEY=your-api-key-here",
        "--entrypoint", "java",
        "whoisfreaks/mcp-server:latest",
        "-jar", "app.jar"
      ]
    }
  }
}

Claude Desktop を開く前に Docker を起動しておく必要があります。イメージは初回使用時に自動で取得されます。

オプション B — JAR を直接使用（Java 17 が必要）

{
  "mcpServers": {
    "whoisfreaks": {
      "command": "java",
      "args": ["-jar", "/absolute/path/to/whoisfreaks-mcp-server-1.0.0.jar"],
      "env": {
        "WHOISFREAKS_API_KEY": "your-api-key-here"
      }
    }
  }
}

手順（どちらのオプションでも共通）：

上記の設定を設定ファイルに貼り付けます（ファイルが存在しない場合は作成します）
ファイルを保存します
Claude Desktop を完全に終了します（macOS では Cmd+Q、Windows ではタスクバーから終了）
Claude Desktop を再度開きます
チャット入力欄のハンマーアイコン（ツール）をクリックすると、14 個の WhoisFreaks ツールが表示されます

動作を確認する： Who owns google.com? と入力すると、Claude が自動的に liveWhoisLookup を呼び出します。

2. Cursor IDE

Cursor は stdio と SSE の両方のトランスポートに対応しています。設定ファイル：~/.cursor/mcp.json

⭐ オプション A — SSE 経由で Docker を使用（推奨）

{
  "mcpServers": {
    "whoisfreaks": {
      "url": "http://localhost:3100/sse",
      "transport": "sse"
    }
  }
}

先に Docker コンテナーを起動します：docker run -d -p 3100:3100 -e WHOISFREAKS_API_KEY=your-key whoisfreaks/mcp-server:latest

オプション B — stdio 経由で Docker を使用（ポート不要）

{
  "mcpServers": {
    "whoisfreaks": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "WHOISFREAKS_API_KEY=your-api-key-here",
        "--entrypoint", "java",
        "whoisfreaks/mcp-server:latest",
        "-jar", "app.jar"
      ]
    }
  }
}

オプション C — JAR を直接使用（Java 17 が必要）

{
  "mcpServers": {
    "whoisfreaks": {
      "command": "java",
      "args": ["-jar", "/absolute/path/to/whoisfreaks-mcp-server-1.0.0.jar"],
      "env": {
        "WHOISFREAKS_API_KEY": "your-api-key-here"
      }
    }
  }
}

手順：

選択したオプションを使用して ~/.cursor/mcp.json を保存します
Cursor を再起動します
AI パネル（Cmd+L）を開くと、WhoisFreaks ツールを示すツールインジケーターが表示されます
Check the SSL certificate for github.com と入力します

3. Windsurf IDE

Windsurf（Codeium 製）は、Cascade AI サイドバー経由で MCP に対応しています。

設定ファイルの場所：

OS	パス
macOS	`~/.codeium/windsurf/mcp_config.json`
Windows	`%USERPROFILE%\.codeium\windsurf\mcp_config.json`
Linux	`~/.codeium/windsurf/mcp_config.json`

⭐ オプション A — stdio 経由で Docker を使用（推奨）

{
  "mcpServers": {
    "whoisfreaks": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "WHOISFREAKS_API_KEY=your-api-key-here",
        "--entrypoint", "java",
        "whoisfreaks/mcp-server:latest",
        "-jar", "app.jar"
      ]
    }
  }
}

オプション B — JAR を直接使用（Java 17 が必要）

{
  "mcpServers": {
    "whoisfreaks": {
      "command": "java",
      "args": ["-jar", "/absolute/path/to/whoisfreaks-mcp-server-1.0.0.jar"],
      "env": {
        "WHOISFREAKS_API_KEY": "your-api-key-here"
      }
    }
  }
}

手順：

選択したオプションを使用して設定を保存します
Windsurf を再起動します
Cascade サイドバーを開き、MCP ツールインジケーター（プラグアイコン）を探します
Find all subdomains of tesla.com と入力します

注：ツールを使用するには、Windsurf の Cascade をWriteモードにする必要があります。ツールが呼び出されない場合は、Cascade ヘッダーから切り替えてください。

4. VS Code + GitHub Copilot

VS Code は、GitHub Copilot 拡張機能（Chat Participants / Tools 機能）を通じて MCP ツールをサポートしています。

設定ファイル（ワークスペース内の .vscode/mcp.json、またはグローバルの ~/.vscode/mcp.json）：

⭐ オプション A — SSE 経由の Docker（推奨、コンテナーを実行しておく必要があります）

{
  "servers": {
    "whoisfreaks": {
      "type": "sse",
      "url": "http://localhost:3100/sse"
    }
  }
}

まずコンテナーを起動してください：docker run -d -p 3100:3100 -e WHOISFREAKS_API_KEY=your-key whoisfreaks/mcp-server:latest

オプション B — stdio 経由の Docker

{
  "servers": {
    "whoisfreaks": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "WHOISFREAKS_API_KEY=your-api-key-here",
        "--entrypoint", "java",
        "whoisfreaks/mcp-server:latest",
        "-jar", "app.jar"
      ]
    }
  }
}

オプション C — JAR を直接使用（Java 17 が必要です）

{
  "servers": {
    "whoisfreaks": {
      "type": "stdio",
      "command": "java",
      "args": ["-jar", "/absolute/path/to/whoisfreaks-mcp-server-1.0.0.jar"],
      "env": {
        "WHOISFREAKS_API_KEY": "your-api-key-here"
      }
    }
  }
}

手順：

GitHub Copilot Chat 拡張機能（v1.99+）がインストールされていることを確認します
上記の設定ファイルを、選択したオプションで保存します
Copilot Chat を開きます（Ctrl+Shift+I / Cmd+Shift+I）
ドロップダウンからモデルを Agent mode に切り替えます
Tools ボタンをクリックします。リストに WhoisFreaks のツールが表示されます
What are the MX records for github.com? と尋ねます

要件： MCP ツールのサポートには、VS Code 1.99+ と GitHub Copilot Chat 拡張機能が必要です。

5. Continue.dev

Continue は、VS Code と JetBrains IDE 向けの MCP サポートを備えたオープンソースの AI コーディングアシスタントです。

設定ファイル（~/.continue/config.json）：

⭐ オプション A — SSE 経由の Docker（推奨、コンテナーを実行しておく必要があります）

{
  "mcpServers": [
    {
      "name": "whoisfreaks",
      "url": "http://localhost:3100/sse",
      "transport": "sse"
    }
  ]
}

まずコンテナーを起動してください：docker run -d -p 3100:3100 -e WHOISFREAKS_API_KEY=your-key whoisfreaks/mcp-server:latest

オプション B — stdio 経由の Docker

{
  "mcpServers": [
    {
      "name": "whoisfreaks",
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "WHOISFREAKS_API_KEY=your-api-key-here",
        "--entrypoint", "java",
        "whoisfreaks/mcp-server:latest",
        "-jar", "app.jar"
      ]
    }
  ]
}

オプション C — JAR を直接使用（Java 17 が必要です）

{
  "mcpServers": [
    {
      "name": "whoisfreaks",
      "command": "java",
      "args": ["-jar", "/absolute/path/to/whoisfreaks-mcp-server-1.0.0.jar"],
      "env": {
        "WHOISFREAKS_API_KEY": "your-api-key-here"
      }
    }
  ]
}

手順：

VS Code Marketplace または JetBrains Plugin Marketplace から Continue 拡張機能をインストールします
選択したオプションを使用して ~/.continue/config.json を編集します
ウィンドウを再読み込みします（Cmd+Shift+P → Reload Window）
Continue サイドバーを開くと、チャットで WhoisFreaks のツールを利用できます
Look up IP geolocation for 1.1.1.1 と尋ねます

6. Zed Editor

Zed には、assistant 設定を通じて MCP をサポートする AI アシスタントが組み込まれています。

設定ファイル（~/.config/zed/settings.json）：

⭐ オプション A — stdio 経由の Docker（推奨）

{
  "assistant": {
    "mcp_servers": {
      "whoisfreaks": {
        "command": "docker",
        "args": [
          "run", "-i", "--rm",
          "-e", "WHOISFREAKS_API_KEY=your-api-key-here",
          "--entrypoint", "java",
          "whoisfreaks/mcp-server:latest",
          "-jar", "app.jar"
        ]
      }
    }
  }
}

オプション B — JAR を直接使用（Java 17 が必要です）

{
  "assistant": {
    "mcp_servers": {
      "whoisfreaks": {
        "command": "java",
        "args": ["-jar", "/absolute/path/to/whoisfreaks-mcp-server-1.0.0.jar"],
        "env": {
          "WHOISFREAKS_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}

手順：

Zed を開きます → Zed メニュー → Settings（または Cmd+,）
選択したオプションを使用して、既存の設定 JSON に mcp_servers ブロックを追加します
保存して Zed を再起動します
AI パネルを開くと（Cmd+?）、ツールインジケーターの下にツールが表示されます
Is the domain myapp.io available? と尋ねます

プロンプトの例

上記のいずれかのクライアントで設定したら、次のプロンプトを試してください。

# WHOIS
Who owns the domain apple.com? Give me full WHOIS details.
Show me the complete ownership history for whoisfreaks.com.
Find all domains registered by [email protected].

# IP & ASN WHOIS
What organization owns the IP address 8.8.8.8?
Look up ASN information for AS15169.

# DNS
What are the MX and NS records for github.com?
Has facebook.com changed its IP addresses in the last 2 years? (DNS history)
Which domains are pointing to the IP 104.21.0.0? (reverse DNS)

# IP Intelligence
Where is 1.1.1.1 located? What ISP runs it?
Is 185.220.101.45 a Tor exit node or a VPN?

# Domain Tools
Is mycompany.io available to register? Suggest 5 alternatives.
List all known subdomains of tesla.com.
Find domains similar to 'google' — possible typosquatting targets.

# SSL
Check the SSL certificate for github.com — who issued it and when does it expire?

環境変数

変数	必須	説明
`WHOISFREAKS_API_KEY`	はい	whoisfreaks.com/billing から取得した API キーです。14 個すべてのツールはこのキーを使用して `api.whoisfreaks.com` を直接呼び出します。他の変数は必要ありません。

トラブルシューティング

API エラー

問題	原因	対処方法
`WHOISFREAKS_API_KEY is not set`	環境変数がありません	Docker コマンドに `-e WHOISFREAKS_API_KEY=your-key` を追加するか、クライアント設定の `env` ブロックに追加します
`Unauthorized (HTTP 401/403)`	API キーが無効、または有効化されていません	whoisfreaks.com/billing でキーを確認します
`No data found (HTTP 404)`	ドメイン／IP／ASN がデータベースにありません	入力値が正しいことを再確認します
`Rate limit reached (HTTP 429)`	リクエストが多すぎます	リクエスト頻度を下げるか、プランをアップグレードします
`Credit limit exceeded (HTTP 413)`	クレジットを使い切りました	whoisfreaks.com/billing でクレジットを追加します
`Timeout (HTTP 408)`	上流の WHOIS サーバーの応答が遅れています	再試行します。一部の TLD では WHOIS サーバーの応答が遅い場合があります

Docker のエラー

問題	原因	対処方法
`Cannot connect to Docker daemon`	Docker Desktop が起動していません	Docker Desktop を開き、エンジンが起動するまで待ちます
コンテナーがすぐに終了する	API キーがない、またはエントリーポイントが正しくありません	ログを確認します：`docker logs whoisfreaks-mcp`
`port 3100 already in use`	ポート 3100 を別のプロセスが使用しています	プロセスを停止します：`docker rm -f whoisfreaks-mcp` を実行してから再試行します
`no such image`	イメージがまだプルされていません	先に `docker pull whoisfreaks/mcp-server:latest` を実行します
Claude Desktop：Docker の設定でツールが表示されない	アプリから確認できる PATH に Docker がありません	Docker の絶対パス `/usr/local/bin/docker` を `command` として指定します
`lstat deploy: no such file or directory`（CI/CD）	GitHub Actions で相対パスに問題があります	絶対パスには `${{ github.workspace }}/deploy/Dockerfile` を使用します
ゲートウェイがポート 3100 で `connection refused` になる	コンテナーが起動していないか、ポートがマッピングされていません	`docker ps` を実行し、実行コマンドに `-p 3100:3100` が含まれていることを確認します
数秒後に SSE 接続が切断される	Nginx のプロキシタイムアウト	Nginx の location ブロックに `proxy_read_timeout 3600s;` を追加します

クライアントのエラー

問題	原因	対処方法
クライアントにツールが表示されない	設定が保存されていないか、クライアントが再起動されていません	設定を保存し、クライアントを完全に終了してから再度開きます
`UnsupportedClassVersionError`（JAR モード）	Java のバージョンが古すぎます	Java 17 以降にアップグレードします（`java -version` で確認できます）
JAR のパスが間違っています	設定で相対パスを使用しています	JAR の絶対パスを指定します
Cursor にツールは表示されるが、呼び出されない	エージェントモードが有効になっていません	Cursor をチャットモードではなく、Agent モードに切り替えます
Claude Desktop が whoisfreaks のエントリーを無視する	stdio ではなく SSE URL が使用されています	Claude Desktop には `url` ではなく `command`／`args` が必要です。上記の Docker stdio 設定を使用します
Windsurf でツールが呼び出されない	Cascade モードが正しくありません	Cascade ヘッダーから Cascade を Write モードに切り替えます

リンク

WhoisFreaks API ドキュメント： https://whoisfreaks.com/documentation
API キーと請求： https://whoisfreaks.com/billing
MCP プロトコル仕様： https://modelcontextprotocol.io
MCP Inspector（テストツール）： npx @modelcontextprotocol/inspector
問題とサポート： GitHub で issue を作成してください

Markdown 対応

ログインしてコメント

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

Whoisfreaks

Whoisfreaks について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

WhoisFreaks MCP Server

目次

ツールリファレンス

WHOIS ツール

IP および ASN の WHOIS ツール

DNS ツール

IP インテリジェンスツール

ドメインツール

SSL ツール

クイックスタート

⭐ 推奨 — Docker

オプション 1 — 直接 docker run（最も簡単）

オプション 2 — Docker Compose（本番環境／VM での使用に推奨）

Docker が動作していることを確認する

Claude Desktop で使用する（Docker の stdio モード）

ソースからビルド

前提条件

プラットフォームとの連携

1. Claude Desktop

2. Cursor IDE

3. Windsurf IDE

4. VS Code + GitHub Copilot

5. Continue.dev

6. Zed Editor

プロンプトの例

環境変数

トラブルシューティング

API エラー

Docker のエラー

クライアントのエラー

リンク

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？

オプション 1 — 直接 `docker run`（最も簡単）