Whispergraph Mcp Server

WhisperGraph MCP 服务

面向 AI Agent 的互联网基础设施图谱——46B 个节点和边，映射 DNS、IP、ASN、BGP、WHOIS、Web 链接和威胁情报。通过 2 次 HTTP 调用即可完成程序化注册。

---

WhisperGraph 是一个由全球最大的互联网基础设施图数据库提供支持的 MCP 服务——涵盖 20 种实体类型的 460 亿个节点和边，将每个域名、IP、ASN、前缀、组织、Web 链接和威胁情报列表映射到一个可通过 Cypher 查询的图谱中。安全团队、事件响应人员和 AI Agent 使用它来进行调查、归因、品牌保护和基础设施取证。

从第一天起就为 Agent 而构建。

• 通过 2 次 HTTP 调用完成程序化注册。 无需浏览器、验证码或人工介入。只需验证电子邮件。约 5 秒即可获得可用的 API 密钥。
• 人人都可免费试用，包括 Agent。付费层级提供更高配额。

你可以查询：

• DNS：解析、名称服务器、MX、SPF 链、DNSSEC
• 路由：ASN 所有权、BGP 源历史、MOAS 冲突、对等互联
• 托管与所有权：注册商、WHOIS 联系人、组织映射
• 威胁情报：涵盖 18 个类别的约 40 个信息源，使用 CALL explain() 获取完整威胁评分
• 历史记录：WHOIS 历史、BGP 路由变更
• Web：109 亿个超链接，用于域间分析

了解更多： Agent 注册 · WhisperGraph 简介 · Cypher API 参考 · 查询指南 · Cypher 语法 · 函数 · 最佳实践 · MCP 设置

快速开始

你需要一个 WhisperGraph API 密钥。可通过以下任一方式获取：

• 程序化获取（推荐用于 Agent）——请参阅下方的 Agent 快速入门。
• 通过控制台获取（推荐用于人工用户）——访问 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 层的团队。请参阅如何设置。

Agent 快速入门

通过 2 次 HTTP 调用即可获得可用的 API 密钥——无需浏览器、验证码或候补名单。

步骤 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	按 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 下的对应页面。

资源

提供 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 调用以编程方式获取，或通过控制面板获取。
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。