WhisperGraph MCP

官方

開源、可自託管的 MCP 伺服器，用於 WhisperGraph — 一個包含 73.9 億節點 / 390 億邊的圖譜，映射 DNS、BGP、GeoIP、WHOIS 及威脅情資。提供六個唯讀工具（Cypher 查詢 + 結構描述內省 + 威脅評估）、六個資源、八個調查提示。支援 stdio 與 Streamable HTTP 傳輸。

GitHub

你可以用 Whisper Graph MCP 做什麼？

查詢網際網路基礎設施圖譜 — 透過 query 對 460 億個 DNS、IP、ASN、BGP、WHOIS 及網頁連結節點執行 Cypher 查詢。
探索可用的資料類型 — 使用 list_labels 列出所有節點標籤及其數量，或透過 describe_label 檢視某個標籤的屬性。
評估指標的威脅態勢 — 使用 explain_indicator 取得 IP、主機名稱、CIDR 或 ASN 的威脅分數、等級及影響因素。
執行預建調查腳本 — 透過 run_recipe 執行目錄中的腳本（如 assess、identify 或 attack-path），無需撰寫 Cypher。
擷取歷史 WHOIS 或 BGP 資料 — 使用 whisper_history 查詢某個指標的過往註冊或路由記錄。
發現網域偽冒變體 — 使用 domain_variants 找出與即時圖譜比對後的品牌保護相關網域變體。

文件

WhisperGraph MCP 伺服器

為 AI 代理打造的網際網路基礎設施圖譜 - 460 億個節點與邊，映射 DNS、IP、ASN、BGP、WHOIS、網頁連結與威脅情報。透過 2 次 HTTP 呼叫即可程式化註冊。

WhisperGraph 是一個 MCP 伺服器，背後是全球最大的網際網路基礎設施圖譜資料庫 - 橫跨 20 種實體類型的 460 億個節點與邊，將每個網域、IP、ASN、前綴、組織、網頁連結和威脅情報列表，映射到一個可進行 Cypher 查詢的圖譜中。供安全團隊、事件應變人員和 AI 代理用於調查、歸因、品牌保護和基礎設施鑑識。

從第一天起就為代理打造。

透過 2 次 HTTP 呼叫即可程式化註冊。 無需瀏覽器、無需 CAPTCHA、無需人工介入。僅需電子郵件驗證。約 5 秒內即可取得可用的 API 金鑰。
所有人皆可免費試用，包括代理。付費層級提供更高的配額。

您可以查詢的內容：

DNS：解析、名稱伺服器、MX、SPF 鏈、DNSSEC
路由：ASN 所有權、BGP 起源歷史、MOAS 衝突、對等互連
託管與所有權：註冊商、WHOIS 聯絡人、組織映射
威脅情報：橫跨 18 個類別的約 40 個情報來源，CALL explain() 以獲得完整威脅評分
歷史資料：WHOIS 歷史記錄、BGP 路由變更
網頁：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 呼叫取得可用的 API 金鑰 - 無需瀏覽器、無需 CAPTCHA、無需等候名單。

步驟 1 - 開始註冊（Whisper 會寄送驗證碼到您的電子郵件）：

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

{"email":"your-agent@example.com","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。

工具

全部八個工具均為唯讀。

工具	功能說明
`query`	對 WhisperGraph 執行 Cypher 查詢。在送達後端之前，會根據安全規則集進行驗證。
`list_labels`	列出每個節點標籤及其計數。當您不確定要錨定哪個標籤時，請在撰寫查詢前呼叫此工具。
`describe_label`	確認標籤存在並列舉其屬性鍵。
`explain_indicator`	對 IP、主機名稱、CIDR 或 ASN 進行威脅評估 - 包含評分、等級、因素、來源。
`whisper_history`	查詢指標的歷史 WHOIS 或 BGP 資料。
`domain_variants`	生成網域的錯字搶註／品牌保護變體，並與圖譜進行比對。
`list_recipes`	列出 whisper.security 目錄中完整的現成方案（請參閱下方）。
`run_recipe`	透過 slug 執行任何目錄方案 - 可以是無金鑰的直接程序，或是需要金鑰的多步驟流程。

目錄方案

list_recipes + run_recipe 公開了整個 whisper.security 目錄 - 29 個精選方案，無需手寫 Cypher。內附的目錄 (src/catalog/recipes.json) 是從權威來源透過 npm run sync:catalog 產生，因此它會與平台保持同步。

有兩種方案：

直接方案（無金鑰）。 無需金鑰即可運行的單一圖譜程序（有速率限制）：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 下的頁面。

資源

六個 MCP 資源：完整結構描述、關係圖、Cypher 函式參考、查詢食譜，以及即時的 whisper://stats 和 whisper://quota。

提示

八個調查工作流程提示範本：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`	(無)	您的 WhisperGraph API 金鑰。可透過 2 次 HTTP 呼叫程式化取得或透過儀表板取得。
`MCP_TRANSPORT`	`stdio`	`stdio` 用於本機 CLI 使用，`http` 用於遠端／Docker。
`HTTP_HOST`	`0.0.0.0`	HTTP 傳輸的綁定主機。
`HTTP_PORT`	`8080`	HTTP 傳輸的綁定埠。
`WHISPER_ALLOWED_HOSTS`	(無)	逗號分隔的 `Host` 標頭允許清單，用於 HTTP 模式下的 DNS 重新綁定保護。僅在受信任的閘道後方可留空。
`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。