SuperAPI AI 工具集

datadog-mcp-server

Datadog MCP Server 是一个面向 Datadog 可观测性平台的 MCP(Model Context Protocol)服务器,提供 163 个工具,覆盖 metrics、monitors、dashboards、logs、APM、RUM、synthetics、incidents、SLO、fleet、status pages 等 16 个类别。默认只读,防止 AI 代理意外修改数据。其特色在于聚合工具可将 5–7 次连续 API 调用合并为一次结构化响应,并支持完整 SLO 增删改查、Fleet Automation 和 Status Pages 的写入操作。通过 stdio 或 Streamable HTTP 传输,可接入 Claude Desktop、Claude Code 或 ChatGPT Apps SDK。内置令牌效率优化,如 extractFields 投影、DD_TOOLS 分类开关和 search-tools 元工具。还提供 4 个 MCP Prompts 模板,用于事件分诊、监控噪音审计等场景。基于 @us-all MCP 标准构建,使用 Node.js 22+、TypeScript 严格 ESM 等现代技术栈。

访问官网

工具介绍

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_DISABLE 16 类开关以及 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 认证)。

使用方式

  1. 安装与配置:可将服务器添加到 ~/Library/Application Support/Claude/claude_desktop_config.json,或从源码构建。提供具体配置示例(见官方文档)。
  2. 连接:将服务器连接至 Claude Desktop 或 Claude Code,然后可使用自然语言提示。
  3. 示例提示:
    • 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 等共享模式。