Datadog MCP Server 是一个开源的模型上下文协议(MCP)服务器,旨在让 AI 助手能够直接与 Datadog 可观测性平台交互。它由社区维护(us-all/datadog-mcp-server),基于 @us-all MCP 标准构建,提供 163 个工具,覆盖 Datadog 的 16 个主要 API 类别。
用途
该服务器的主要用途是让 AI 代理(如 Claude、ChatGPT)能够查询和操作 Datadog 中的监控数据,回答诸如“为什么发生这种情况?”的问题,而不仅仅是“值是多少?”。它特别适合需要深度可观测性分析、事件分诊、SLO 合规检查、监控噪音审计等场景。
主要能力
- 广泛的 API 覆盖:163 个工具分为 16 类:metrics、monitors、dashboards、logs、apm、rum、incidents、security、synthetics、ci、infra、fleet、status-pages、oncall、teams、account。
- 聚合工具:如
analyze-monitor-state和slo-compliance-snapshot可将 5–7 次顺序 API 调用折叠为一个结构化响应,并包含caveats数组以处理部分失败。 - 完整 SLO CRUD:支持创建、更新、删除 SLO 及其修正项,而官方 Bits AI MCP 和社区替代品通常只读。
- Fleet Automation:15 个工具涵盖代理、部署和调度,仅此服务器提供。
- Status Pages:21 个工具支持状态页全生命周期(组件、降级、维护)。
- 令牌效率设计:通过
extractFields投影、DD_TOOLS/DD_DISABLE16 类开关以及search-tools元工具,在 163 个工具中保持低 LLM 上下文消耗。 - Apps SDK 卡片:
slo-compliance-snapshot可通过_meta["openai/outputTemplate"]在 ChatGPT 客户端渲染为可视化卡片;Claude 客户端接收相同 JSON 内容。 - 传输方式:默认 stdio(用于 Claude Desktop / Code)。设置
MCP_TRANSPORT=http可启用 Streamable HTTP,用于 ChatGPT Apps SDK 或远程客户端(通过MCP_HTTP_TOKEN进行 Bearer 认证)。
使用方式
- 安装与配置:可将服务器添加到
~/Library/Application Support/Claude/claude_desktop_config.json,或从源码构建。提供具体配置示例(见官方文档)。 - 连接:将服务器连接至 Claude Desktop 或 Claude Code,然后可使用自然语言提示。
- 示例提示:
- SLO 健康:“列出我的 SLO 及其本月剩余错误预算。按状态分组:合规、风险、违约。”
- 事件分诊:“checkout-service 上有活动事件。拉取关联监控、APM 近期错误峰值,以及过去 24 小时内涉及该服务的部署。”
- 监控噪音审计:“找出过去 7 天内告警超过 10 次但 MTTR 低于 5 分钟的监控——这些可能是抖动。”
- RUM 错误峰值:“今天 14:00 到 14:30 之间 checkout 漏斗的 RUM 错误率跃升。显示顶部错误组、受影响会话以及错误前的用户操作。”
- Fleet 部署:“安排 datadog-agent 7.55.0 在下周六开始,仅周末部署到 staging 集群。”
适用场景
- 需要与 Datadog 进行深度交互的 AI 代理工作流。
- 自托管场景(内部站点、隔离网络、开发/CI 沙箱)。
- 需要 SLO、Fleet、Status Pages 写入对等的操作。
- 希望减少 LLM 上下文消耗的团队。
限制
- 默认只读,所有写入操作需设置
DD_ALLOW_WRITE=true。 - 部分工具(如 Fleet、Status Pages)仅此服务器提供,可能与官方 MCP 不兼容。
- 需要 Node.js 22+ 环境。
- 官方 MCP(Bits AI MCP)是互补而非替代,官方适合快速托管入门和 SSO。
MCP Prompts 与资源
- 提供 4 个提示模板:
triage-incident、audit-monitor-noise、analyze-rum-error-spike、investigate-slow-trace。 - 只读实体 URI:
dd://monitor/{id}、dd://dashboard/{id}、dd://slo/{id}等。
技术栈
Node.js 22+、TypeScript 严格 ESM、pnpm、@modelcontextprotocol/sdk、@datadog/datadog-api-client(官方)、zod、dotenv、vitest + dd-trace。基于 @us-all/mcp-toolkit,提供 extractFields、aggregate、createWrapToolHandler 等共享模式。