使用说明
Datadog MCP服务器
回答问题的Datadog MCP “为什么会发生这种情况?” --不只是 “价值是什么?”
聚合工具,将5-7个顺序的API调用合并为一个结构化响应。全SLO CRUD。车队自动化。任何MCP中最广泛的Datadog API覆盖范围- 163工具 建立在 @我们都是MCP标准.
它有什么其他人没有的
- 聚合工具 —
analyze-monitor-state和slo-compliance-snapshot使用caveats部分故障的数组。没有其他Datadog MCP提供这种模式。 - 全SLO原油 --创建、更新、删除SLO(及其更正)。官方的Bits AI MCP和社区替代方案在SLO上是只读的。
- 车队自动化 --跨部署和时间表的15个工具。只有这台服务器。
- 状态页 --21个工具用于完整的状态页面生命周期(组件、降级、维护)。只有这台服务器。
- 代币设计高效 —
extractFields投影,DD_TOOLS/DD_DISABLE16个类别切换,以及一个search-tools元工具在163个工具中保持LLM上下文较低。 - Apps SDK卡 —
slo-compliance-snapshot通过以下方式在ChatGPT客户端上呈现为可视卡_meta["openai/outputTemplate"].Claude客户端接收相同的JSON内容(不中断)。 - stdio+流式HTTP --默认为stdio(克劳德桌面/代码)。集
MCP_TRANSPORT=http适用于ChatGPT Apps SDK或远程客户端(通过承载身份验证MCP_HTTP_TOKEN).
试试这个——5个提示
将服务器连接到Claude Desktop或Claude Code,然后粘贴其中任何一个:
- SLO健康 — “列出我的SLO及其本月剩余的错误预算。按状态分组:合规、有风险、违规。”
- 事故分流 — “有一个活跃的事件
checkout-service。从APM中提取链接的监视器、最近的错误峰值以及过去24小时内哪些部署触及了该服务。" - 监控噪音审计 — “找到在过去7天内发出10次以上警报但MTTR低于5分钟的监测器——这些监测器可能正在摆动。”
- RUM错误尖峰 — “今天14:00至14:30之间,RUM错误率在结账漏斗上跃升。请向我展示最常见的错误组、受影响的会话以及错误前的用户操作。”
- 舰队部署 — “安排
datadog-agent7.55.0推出到staging集群,仅限周末,从下周六开始。"
何时使用此与Datadog的官方MCP
Datadog的官方MCP(Bits AI MCP,GA 2026-03-09)是 互补的,而不是替代品:
| 官方数据狗MCP | @us-all/datadog-mcp (这个) |
|
|---|---|---|
| 刀具数量 | 16+核心刀具组 | 163工具 整个API表面 |
| 部署 | 远程(由Datadog管理) | 自托管 stdio(npx/Docker/npm) |
| auth | datadogSSO | neneneba API+应用程序密钥 |
| 网站 | 公共数据狗网站 | 任何网站,包括内部/主权网站;US5违约 |
| SLO写道 | ❌ | ✅ 创建/更新/删除SLO+更正 |
| 车队自动化 | ❌ | ✅ 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}等等。 |
使用官方Bits AI MCP进行快速管理入职和SSO。当您需要API全面覆盖、SLO/fleet/status-page写入奇偶校验或自托管(内部站点、隔离网络、dev/CI沙盒)时,请使用此选项。
安装
克劳德桌面
添加 ~/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 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 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密钥 |
DD_APP_KEY |
✅ | — | Datadog应用程序密钥 |
DD_SITE |
❌ | us5.datadoghq.com |
Datadog网站(见下表) |
DD_ALLOW_WRITE |
❌ | false |
设置 true 启用突变(创建/更新/删除) |
DD_TOOLS |
❌ | — | 逗号分隔所有类别。只有这些加载-最大的令牌节省。 |
DD_DISABLE |
❌ | — | 逗号分开。当被忽略时 DD_TOOLS 已设置。 |
MCP_TRANSPORT |
❌ | stdio |
http 启用流式HTTP传输 |
MCP_HTTP_TOKEN |
条件 | -- | 承载令牌。需要时 MCP_TRANSPORT=http |
MCP_HTTP_PORT |
❌ | 3000 |
HTTP侦听端口 |
MCP_HTTP_HOST |
❌ | 127.0.0.1 |
HTTP绑定主机(为本地主机自动启用DNS重新绑定保护) |
MCP_HTTP_SKIP_AUTH |
❌ | false |
跳过承载身份验证——例如,在处理它的反向代理后面 |
分类 (16): metrics, monitors, dashboards, logs, apm, rum, incidents, security, synthetics, ci, infra, fleet, status-pages, oncall, teams, account.
当 MCP_TRANSPORT=http: POST /mcp (承载身份验证JSON-RPC)+ GET /health (公众的活跃度)。
站点:
| 地点 | 价值 | 地区 |
|---|---|---|
| 美国1 | datadoghq.com |
美国(弗吉尼亚州) |
| 美国3 | us3.datadoghq.com |
美国(弗吉尼亚州) |
| 美国5 | us5.datadoghq.com |
美国(俄勒冈州) |
| EU1 | datadoghq.eu |
欧盟(法兰克福) |
| AP1 | ap1.datadoghq.com |
亚太地区(东京) |
代币效率
在任何对话之前,天真的设置都会加载约25K个工具模式令牌。三个旋钮缓解:
| 场景 | 工具 | 架构令牌 | 与默认值 |
|---|---|---|---|
| 默认值(所有类别) | 163 | 25200 | -- |
典型(DD_TOOLS=metrics,monitors,logs,apm,dashboards) |
55 | 9,300 | −63% |
狭窄(DD_TOOLS=metrics,monitors) |
24 | 3,800 | −85% |
- 类别切换 —
DD_TOOLS=metrics,monitors,logs,apm(最大的胜利)。 extractFields反应投影 —get-dashboard { dashboardId: "abc", extractFields: "id,title,widgets.*.definition.type" }.search-tools元工具 --始终启用;让LLM在运行时发现工具,而不是预加载所有模式。
只读模式
默认情况下,所有写入都被阻止,以防止AI代理的意外突变。以下要求 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,加上所有舰队/状态页面/安全写入。
MCP提示(4)
模型可以直接调用的工作流模板:
triage-incident--给定一个事件ID,遍历链接的监视器、最近的错误峰值和最近的部署。audit-monitor-noise--通过警报频率×MTTR监测旗帜拍打。analyze-rum-error-spike--两个窗口的RUM错误率差异,归因于顶级错误组。investigate-slow-trace--给定一个慢速跟踪ID,遍历跨度树和曲面瓶颈跨度。
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 |
| 车队自动化 | 15 |
| 综合指标、对数/跨度指标、SLO校正 | 16 |
| 显示器、仪表板、笔记本电脑、活动 | 16 |
| 事件、案例、错误跟踪、审计 | 13 |
| OnCall、团队、用户、服务、机器人 | 11 |
| 安全信号+规则+抑制 | 9 |
| APM、CI可见性、DORA、网络设备 | 9 |
| +聚合 | analyze-monitor-state, slo-compliance-snapshot |
| +meta | search-tools |
Full tool list (click to expand)
指标(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
朗姆酒(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
斯洛斯(6)
list-slos, get-slo, get-slo-history, create-slo, update-slo, delete-slo, slo-compliance-snapshot (聚合),加上5个SLO校正工具
合成药物(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
多拉(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
日志/跨度/APM保留度量(15)
每个5 logs-metrics, spans-metrics, apm-retention-filters (列表/获取/创建/更新/删除)
状态页(21)
完整生命周期:页面、组件、降级、维护。看 src/tools/status-pages.ts.
车队自动化(15)
代理、部署、时间表。看 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
extractFields--令牌高效响应预测aggregate(fetchers, caveats)--聚合工具的扇出助手createWrapToolHandler-域特定编校(DD_API_KEY/DD_APP_KEY)+数据狗ApiException错误提取search-tools元工具
技术栈
Node.js 22+•TypeScript严格ESM•pnpm• @modelcontextprotocol/sdk • @datadog/datadog-api-client (官方)•zod•dotenv•vitest+dd跟踪。
贡献
看 贡献.md新的共享模式属于 @us-all/mcp-toolkit --7服务器套件的单一真相来源。