datadog

Datadog MCP Server

能回答“为什么会发生这种情况？”的 Datadog MCP，而不只是“数值是多少？”

聚合工具可将 5–7 次连续 API 调用合并为一个结构化响应。完整的 SLO 增删改查。Fleet 自动化。在任何 MCP 中拥有最广泛的 Datadog API 覆盖范围——基于 @us-all MCP standard 构建的 163 个工具。

它的独到之处

• 聚合工具 — analyze-monitor-state 和 slo-compliance-snapshot 可将 5–7 次连续 API 调用合并为一个结构化响应，并通过 caveats 数组说明部分失败情况。其他 Datadog MCP 都没有提供这种模式。
• 完整的 SLO 增删改查 — 创建、更新和删除 SLO（及其更正记录）。官方 Bits AI MCP 和社区替代方案对 SLO 都只有只读权限。
• Fleet 自动化 — 提供涵盖部署和计划的 15 个工具。只有此服务支持。
• 状态页面 — 提供 21 个工具，覆盖状态页面的完整生命周期（组件、降级事件、维护）。只有此服务支持。
• 专为节省令牌而设计 — extractFields 投影、DD_TOOLS/DD_DISABLE 16 类别开关，以及 search-tools 元工具，可在 163 个工具中减少大模型上下文占用。
• Apps SDK 卡片 — 在 ChatGPT 客户端中，slo-compliance-snapshot 会通过 _meta["openai/outputTemplate"] 渲染为可视化卡片。Claude 客户端会收到相同的 JSON 内容（保持向后兼容）。
• stdio + Streamable HTTP — 默认使用 stdio（Claude Desktop / Code）。对于 ChatGPT Apps SDK 或远程客户端，设置 MCP_TRANSPORT=http（通过 MCP_HTTP_TOKEN 使用 Bearer 身份验证）。

试试这 5 个提示词

将服务连接到 Claude Desktop 或 Claude Code，然后粘贴以下任意提示词：

1. SLO 健康状况 — “列出我的 SLO 和本月剩余的错误预算，并按状态分组：符合要求、有风险、已超标。”
2. 事件分诊 — “checkout-service 上发生了一个正在处理的事件。找出关联的监控器、APM 中近期的错误峰值，以及过去 24h 内影响该服务的部署。”
3. 监控噪声审查 — “找出过去 7 天内触发超过 10 次，但 MTTR 不到 5 分钟的监控器——它们可能在反复抖动。”
4. RUM 错误峰值 — “今天 14:00 到 14:30 之间，checkout 漏斗的 RUM 错误率突然升高。显示排名靠前的错误组、受影响的会话，以及错误发生前用户执行的操作。”
5. Fleet 部署 — “安排将 datadog-agent 7.55.0 部署到 staging 集群，仅限周末，从下周六开始。”

何时使用此工具，而不是 Datadog 官方 MCP

Datadog 官方 MCP（Bits AI MCP，GA 2026-03-09）是互补方案，而非替代品：

	官方 Datadog MCP	@us-all/datadog-mcp（此工具）
工具数量	16+ 个核心工具集	覆盖完整 API 的 163 个工具
部署方式	远程（由 Datadog 管理）	自托管 stdio（npx / Docker / npm）
身份验证	Datadog SSO	API + APP key
站点	Datadog 公共站点	任意站点，包括内部／主权站点；默认 US5
SLO 写入	❌	✅ 创建／更新／删除 SLO + 修正
Fleet 自动化	❌	✅ 15 个工具
状态页	❌	✅ 21 个工具
聚合工具	❌	✅ analyze-monitor-state、slo-compliance-snapshot
MCP 提示词	❌	✅ 4 个（triage-incident、audit-monitor-noise、analyze-rum-error-spike、investigate-slow-trace）
MCP 资源	❌	✅ dd://service/{serviceName}、dd://team/{teamId}、dd://synthetics/{testId} 等

如果想快速托管式接入并使用 SSO，请使用官方 Bits AI MCP。如果需要完整 API 覆盖、SLO／Fleet／状态页写入功能对等，或需要自托管（内部站点、隔离网络、开发／CI 沙箱），请使用此工具。

安装

Claude Desktop

将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "datadog": {
      "command": "npx",
      "args": ["-y", "@us-all/datadog-mcp"],
      "env": {
        "DD_API_KEY": "<your-api-key>",
        "DD_APP_KEY": "<your-app-key>",
        "DD_SITE": "datadoghq.com"
      }
    }
  }
}

Claude Code

claude mcp add datadog -s user \
  -e DD_API_KEY=<your-api-key> -e DD_APP_KEY=<your-app-key> -e DD_SITE=datadoghq.com \
  -- npx -y @us-all/datadog-mcp

Docker

docker run -e DD_API_KEY=... -e DD_APP_KEY=... -e DD_SITE=datadoghq.com \
  ghcr.io/us-all/datadog-mcp-server:latest

从源代码构建

git clone https://github.com/us-all/datadog-mcp-server.git
cd datadog-mcp-server && pnpm install && pnpm build
node dist/index.js

配置

变量	必需	默认值	说明
DD_API_KEY	✅	—	Datadog API key
DD_APP_KEY	✅	—	Datadog Application key
DD_SITE	❌	us5.datadoghq.com	Datadog 站点（见下表）
DD_ALLOW_WRITE	❌	false	设置为 true 以启用变更操作（创建／更新／删除）
DD_TOOLS	❌	—	以逗号分隔的类别允许列表。仅加载这些类别，是节省令牌的最佳方式。
DD_DISABLE	❌	—	以逗号分隔的类别拒绝列表。设置 DD_TOOLS 时会忽略此项。
MCP_TRANSPORT	❌	stdio	设置为 http 以启用 Streamable HTTP 传输
MCP_HTTP_TOKEN	有条件必需	—	Bearer 令牌。MCP_TRANSPORT=http 时必需
MCP_HTTP_PORT	❌	3000	HTTP 监听端口
MCP_HTTP_HOST	❌	127.0.0.1	HTTP 绑定主机（localhost 会自动启用 DNS 重绑定保护）
MCP_HTTP_SKIP_AUTH	❌	false	跳过 Bearer 身份验证，例如在由反向代理处理身份验证时

类别（16 个）：metrics、monitors、dashboards、logs、apm、rum、incidents、security、synthetics、ci、infra、fleet、status-pages、oncall、teams、account。

当 MCP_TRANSPORT=http 时：POST /mcp（Bearer 身份验证的 JSON-RPC）+ GET /health（公开存活状态）。

站点：

站点	值	区域
US1	datadoghq.com	美国（弗吉尼亚）
US3	us3.datadoghq.com	美国（弗吉尼亚）
US5	us5.datadoghq.com	美国（俄勒冈）
EU1	datadoghq.eu	欧盟（法兰克福）
AP1	ap1.datadoghq.com	亚太地区（东京）

令牌效率

简单配置在开始对话前会加载约 25K 个令牌的工具架构。以下三种设置可减少用量：

场景	工具数	架构令牌数	相比默认值
默认（所有类别）	163	25,200	—
常用（DD_TOOLS=metrics,monitors,logs,apm,dashboards）	55	9,300	−63%
精简（DD_TOOLS=metrics,monitors）	24	3,800	−85%

1. 类别开关 — DD_TOOLS=metrics,monitors,logs,apm（效果最显著）。
2. extractFields 响应投影 — get-dashboard { dashboardId: "abc", extractFields: "id,title,widgets.*.definition.type" }。
3. search-tools 元工具 — 始终启用；让 LLM 在运行时发现工具，而不是预加载所有架构。

只读模式

默认情况下，所有写入操作都会被阻止，以防 AI Agent 意外修改数据。以下操作需要设置 DD_ALLOW_WRITE=true：

create-monitor、update-monitor、delete-monitor、mute-monitor、create-dashboard、update-dashboard、delete-dashboard、send-logs、post-event、trigger-synthetics、create-synthetics-test、update-synthetics-test、delete-synthetics-test、create-downtime、cancel-downtime、create-case、update-case-status、send-dora-deployment、send-dora-incident、create-slo、update-slo、delete-slo，以及所有 Fleet、状态页和安全相关的写入操作。

MCP 提示词（4 个）

模型可直接调用的工作流模板：

• triage-incident — 给定事件 ID，遍历关联的监控器、近期错误激增情况和近期部署。
• audit-monitor-noise — 根据告警频率 × MTTR 标记频繁波动的监控器。
• analyze-rum-error-spike — 对比两个时间窗口的 RUM 错误率，并将其归因于主要错误组。
• investigate-slow-trace — 给定慢速 Trace ID，遍历 Span 树并找出瓶颈 Span。

MCP 资源

按 URI 读取的只读实体：dd://monitor/{id}、dd://dashboard/{id}、dd://slo/{id}、dd://incident/{id}、dd://service/{serviceName}、dd://team/{teamId}（团队及成员）、dd://synthetics/{testId}、dd://host/{name}。

工具参考

16 个类别中共有 163 个工具。使用 search-tools 元工具在运行时发现工具；完整列表已在下方折叠。

领域	工具
状态页	21
RUM（事件 + 应用 + 指标 + 保留）	27
指标、主机、SLO、停机时间、容器、进程	19
Fleet 自动化	15
Synthetics、日志/Span 指标、SLO 修正	16
监控器、仪表板、笔记本、事件	16
事件、案例、错误跟踪、审计	13
OnCall、团队、用户、服务、机器人	11
安全信号 + 规则 + 抑制	9
APM、CI 可观测性、DORA、网络设备	9
+ 聚合	analyze-monitor-state、slo-compliance-snapshot
+ 元工具	search-tools

完整工具列表（点击展开）

指标（5）

query-metrics、get-metrics、get-metric-metadata、list-active-metrics、list-metric-tags

监控器（7）

get-monitors、get-monitor、create-monitor、update-monitor、delete-monitor、mute-monitor、validate-monitor、analyze-monitor-state (聚合)

仪表板（5）

get-dashboards、get-dashboard、create-dashboard、update-dashboard、delete-dashboard

日志（3）

search-logs、aggregate-logs、send-logs

事件（2）

get-events、post-event

事件（6）

get-incidents、get-incident、search-incidents、create-incident、update-incident、delete-incident

APM（1）

search-spans

RUM（17）

search-rum-events、aggregate-rum、list-rum-applications、get-rum-application、create-rum-application、update-rum-application、delete-rum-application、list-rum-metrics、get-rum-metric、create-rum-metric、update-rum-metric、delete-rum-metric、list-rum-retention-filters、get-rum-retention-filter、create-rum-retention-filter、update-rum-retention-filter、delete-rum-retention-filter

SLO（6）

list-slos、get-slo、get-slo-history、create-slo、update-slo、delete-slo、slo-compliance-snapshot (聚合)，以及 5 个 SLO 修正工具

Synthetics（6）

list-synthetics、get-synthetics-result、trigger-synthetics、create-synthetics-test、update-synthetics-test、delete-synthetics-test

主机 / 容器 / 进程（4）

list-hosts、get-host-totals、list-containers、list-processes

停机时间（3）

list-downtimes、create-downtime、cancel-downtime

安全（9）

search-security-signals、get-security-signal、list-security-rules、get-security-rule、delete-security-rule、list-security-suppressions、get-security-suppression、create-security-suppression、delete-security-suppression

CI 可见性（4）

search-ci-pipelines、aggregate-ci-pipelines、search-ci-tests、aggregate-ci-tests

案例（4）

list-cases、get-case、create-case、update-case-status

错误跟踪（2）

list-error-tracking-issues、get-error-tracking-issue

DORA（2）

send-dora-deployment、send-dora-incident

网络设备（2）

list-network-devices、get-network-device

笔记本（2）

list-notebooks、get-notebook

OnCall（2）

get-team-oncall、get-oncall-schedule

服务与软件目录（2）

list-services、get-service-definition

团队（6）

list-teams、get-team、create-team、update-team、delete-team、get-team-members

账户与用户（2）

get-usage-summary、list-users

日志/Span/APM 保留指标（15）

logs-metrics、spans-metrics、apm-retention-filters 各有 5 个（list/get/create/update/delete）

状态页面（21）

完整生命周期：页面、组件、降级事件、维护事件。参见 src/tools/status-pages.ts。

Fleet Automation（15）

Agent、部署、计划。参见 src/tools/fleet.ts。

审计（1）

search-audit-logs

元工具（1）

search-tools — 按关键词查询其他工具；无论 DD_TOOLS 的设置如何，始终启用。

架构

Claude → MCP stdio → index.ts → tools/*.ts → @datadog/datadog-api-client → Datadog API

基于 @us-all/mcp-toolkit 构建：

• extractFields — 高效利用令牌的响应投影
• aggregate(fetchers, caveats) — 聚合工具的扇出辅助函数
• createWrapToolHandler — 特定领域的脱敏（DD_API_KEY/DD_APP_KEY）以及 Datadog ApiException 错误提取
• search-tools 元工具

技术栈

Node.js 22+ • TypeScript strict ESM • pnpm • @modelcontextprotocol/sdk • @datadog/datadog-api-client（官方）• zod • dotenv • vitest + dd-trace。

贡献

参见 CONTRIBUTING.md。新的共享模式应放入 @us-all/mcp-toolkit — 这是 7 个服务套件的唯一事实来源。

许可证

MIT