Whispergraph Mcp Server

WhisperGraph MCP サーバー

AI エージェントのためのインターネットインフラストラクチャグラフ。46B 個のノードとエッジで、DNS、IP、ASN、BGP、WHOIS、Web リンク、脅威インテリジェンスをマッピングします。HTTP リクエスト 2 回でプログラムから登録できます。

---

WhisperGraph は、世界最大のインターネットインフラストラクチャグラフデータベースを基盤とする MCP サーバーです。20 種類のエンティティにまたがる 460 億個のノードとエッジを持ち、すべてのドメイン、IP、ASN、プレフィックス、組織、Web リンク、脅威インテリジェンスのリストを、Cypher でクエリ可能な単一のグラフにマッピングします。セキュリティチーム、インシデント対応担当者、AI エージェントが、調査、帰属分析、ブランド保護、インフラストラクチャのフォレンジックに利用しています。

初日からエージェント向けに構築。

• **HTTP リクエスト 2 回でプログラムから登録できます。**ブラウザーも CAPTCHA も人間の介在も不要です。メール認証のみで、約 5 秒で有効な API キーを取得できます。
• エージェントを含むすべてのユーザーに無料トライアルを提供し、より高いクォータに対応する有料プランもあります。

質問できる内容：

• DNS：名前解決、ネームサーバー、MX、SPF チェーン、DNSSEC
• ルーティング：ASN の所有者、BGP のオリジン履歴、MOAS の競合、ピアリング
• ホスティングと所有権：レジストラー、WHOIS の連絡先、組織のマッピング
• 脅威インテリジェンス：18 カテゴリーにまたがる約 40 のフィード、脅威スコアリング全体を確認できる CALL explain()
• 履歴：WHOIS 履歴、BGP ルートの変更
• Web：ドメイン間分析用の 109 億件のハイパーリンク

詳細情報： エージェント登録 · WhisperGraph の概要 · Cypher API リファレンス · クエリガイド · Cypher 構文 · 関数 · ベストプラクティス · MCP のセットアップ

クイックスタート

WhisperGraph API キーが必要です。次のいずれかの方法で取得してください。

• プログラムから取得（エージェントに推奨）— 以下のエージェント向けクイックスタートを参照してください。
• ダッシュボードから取得（人間のユーザーに推奨）— console.whisper.security/sign-up。

ホスト型リモートサーバー（インストール不要）

Whisper は https://mcp.whisper.security でホスト型 MCP サーバーを運用しています。リモートサーバーに対応する MCP クライアントから接続し、API キーで認証してください。

{
  "mcpServers": {
    "whisper": {
      "url": "https://mcp.whisper.security",
      "headers": { "Authorization": "Bearer <your_api_key>" }
    }
  }
}

MCP クライアント（stdio）

ローカルの stdio トランスポートを使用するには、MCP クライアントの設定に以下を追加してください。

{
  "mcpServers": {
    "whisper-graph": {
      "command": "npx",
      "args": ["-y", "@whisper-security/whisper-graph-mcp"],
      "env": { "WHISPER_API_KEY": "your-api-key" }
    }
  }
}

このリポジトリをセルフホストする方法は、MCP レイヤーを独自の環境で実行したいチーム向けです。セットアップ方法を参照してください。

エージェント向けクイックスタート

HTTP リクエスト 2 回で有効な API キーを取得できます。ブラウザーも CAPTCHA もウェイティングリストも不要です。

ステップ 1 — 登録を開始します（Whisper から認証コードがメールで届きます）。

POST https://console.whisper.security/api/signup
Content-Type: application/json

{"email":"[email protected]","attribution":{"agent_name":"your-agent","source":"<registry-name>"}}

ステップ 2 — メールで届いたコードを使って認証します。

POST https://console.whisper.security/api/signup/verify
Content-Type: application/json

{"signup_id":"...","code":"..."}

レスポンスには api_key、mcp_url、dashboard_url、docs_url が含まれます。上記の MCP 設定スニペットで api_key を使用してください。ドキュメント全文：whisper.security/docs/agent-signup。

ツール

8 つのツールはすべて読み取り専用です。

ツール	機能
query	WhisperGraph に対して Cypher クエリを実行します。バックエンドに送信される前に、安全ルールセットに照らして検証されます。
list_labels	すべてのノードラベルと件数を一覧表示します。クエリの起点にするラベルがわからない場合は、クエリを作成する前に呼び出してください。
describe_label	ラベルの存在を確認し、そのプロパティキーを列挙します。
explain_indicator	IP、ホスト名、CIDR、ASN の脅威評価を行います。スコア、レベル、要因、情報源を返します。
whisper_history	指標の過去の WHOIS または BGP データを取得します。
domain_variants	グラフを照合して、ドメインのタイポスクワッティング／ブランド保護用の類似ドメインを確認します。
list_recipes	すぐに使えるレシピを収録した whisper.security カタログ全体を一覧表示します（下記参照）。
run_recipe	スラッグを指定してカタログ内の任意のレシピを実行します。キー不要の直接処理、またはキーが必要な複数ステップのフローを実行できます。

カタログのレシピ

list_recipes と run_recipe では、whisper.security カタログ全体を利用できます。厳選された 29 のレシピが用意されており、Cypher を手書きする必要はありません。同梱されているカタログ（src/catalog/recipes.json）は、正規のソースから npm run sync:catalog で生成されるため、プラットフォームの変更が反映されます。

レシピには 2 種類あります。

• 直接レシピ（キー不要）。 キーなしで実行できる単一のグラフプロシージャです（レート制限あり）。assess（脅威状況）、identify（ベンダー／運用者）、explain、variants、origins（CDN の実体特定）、history / history-whois、walk、psl-tldplusone、psl-affiliation、asset、lookup-tor-relay、db-schema。
• フローレシピ（キーが必要）。 API キーが必要な、厳選された複数ステップの調査です。attack-path、attack-surface、indicator-enrichment、infrastructure-mapping、subdomain-takeover、bgp-hijack-exposure、blast-radius、route-health、typosquat、nameserver-hijack-dns-consistency、map-supply-chain-concentration、discover-ai-agent-infrastructure、build-takedown-evidence-package、indicator、anycast-dns-root-sovereignty。

// keyless direct recipe
{ "name": "run_recipe", "arguments": { "recipe": "assess", "inputs": { "v": "185.220.101.33" } } }

// keyed multi-step flow (needs WHISPER_API_KEY / X-API-Key)
{ "name": "run_recipe", "arguments": { "recipe": "indicator-enrichment", "inputs": { "value": "github.com" } } }

各レシピには docsUrl が含まれており（list_recipes で確認できます）、whisper.security/docs 内の対応するページにリンクしています。

リソース

6 つの MCP リソースがあります。完全なスキーマ、関係マップ、Cypher 関数リファレンス、クエリークックブックに加え、ライブの whisper://stats と whisper://quota を利用できます。

プロンプト

調査ワークフロー用のプロンプトテンプレートが 8 つあります。investigate-ip、map-attack-surface、compare-domains、blast-radius、threat-triage、whois-pivot、bgp-investigation、typosquat-sweep。

セルフホスト（Docker / HTTP）

リモート環境またはチームでのデプロイでは、Streamable HTTP 経由でサーバーを実行します。

docker run -p 8080:8080 -e MCP_TRANSPORT=http \
  ghcr.io/whisper-sec/whisper-graph-mcp:latest

または、Docker Compose を使用します。

docker compose up

HTTP モードでは、サーバーは受信リクエストを認証しません。呼び出し元の X-API-Key または Authorization: Bearer ヘッダーを、ホストされた WhisperGraph API に中継します。ヘッダーがない場合は、WHISPER_API_KEY 環境変数にフォールバックします。アクセス制御が必要な場合は、ご自身のゲートウェイの背後に配置してください。

設定

すべての設定は環境変数を使用します。

変数	デフォルト	説明
WHISPER_API_KEY	(none)	WhisperGraph API キーです。HTTP 呼び出し 2 回でプログラムから取得するか、ダッシュボードから取得してください。
MCP_TRANSPORT	stdio	ローカル CLI で使用する場合は stdio、リモート／Docker の場合は http を指定します。
HTTP_HOST	0.0.0.0	HTTP トランスポートのバインド先ホストです。
HTTP_PORT	8080	HTTP トランスポートのバインド先ポートです。
WHISPER_ALLOWED_HOSTS	(none)	HTTP モードでの DNS リバインディング保護に使用する、カンマ区切りの Host ヘッダー許可リストです。信頼できるゲートウェイの背後で使用する場合に限り、空のままにしてください。
WHISPER_DB_URL	https://graph.whisper.security	ホスト型 WhisperGraph API のベース URL です。
WHISPER_QUERY_TIMEOUT_MS	60000	API に転送される、クエリごとのハードタイムアウトです。
WHISPER_DB_TIMEOUT_MS	10000	クエリ以外の呼び出しに対する HTTP タイムアウトです。
LOG_LEVEL	info	debug、info、warn、または error です。

開発

npm install
npm run dev       # run from source over stdio
npm test          # unit + integration tests (no secrets needed)
npm run build     # bundle to dist/
npm run lint      # eslint
npm run typecheck # tsc --noEmit

貢献

貢献を歓迎します。CONTRIBUTING.mdと 行動規範をご覧ください。セキュリティ上の問題については、SECURITY.mdをご覧ください。

ライセンス

Apache-2.0。「Whisper」、Whisper のロゴ、および「WhisperGraph」は Whisper Security の商標です。詳細はNOTICEをご覧ください。