Datadog MCP

🚀 Datadog MCP 服务器

Datadog MCP 服务器是一个用于与 Datadog API 交互的 Model Context Protocol (MCP) 服务器，能帮助用户便捷地访问和管理 Datadog 平台上的各类数据与配置。

🚀 快速开始

Datadog MCP 服务器可让你轻松与 Datadog API 进行交互。在开始使用前，请确保满足先决条件，并完成安装与配置。

✨ 主要特性

• 监控：可访问监控数据和配置，实时掌握系统运行状态。
• 仪表板：能够获取和查看仪表板定义，直观展示关键指标。
• 指标：支持查询可用指标及其元数据，深入了解系统性能。
• 事件：可在时间段内搜索和检索事件，及时发现系统异常。
• 日志：能使用高级过滤和排序选项搜索日志，精准定位问题。
• 事故：可访问事故管理数据，有效应对系统故障。
• API 集成：直接与 Datadog 的 v1 和 v2 API 集成，拓展功能应用。
• 全面错误处理：提供清楚的错误消息，针对 API 和身份验证问题，方便排查故障。

📦 安装指南

通过 npm (推荐)

npm install -g datadog-mcp-server

从源代码

1. 克隆此仓库。
2. 安装依赖项：

npm install

3. 构建项目：

npm run build

📚 详细文档

配置

你可以使用环境变量或命令行参数来配置 Datadog MCP 服务器。

环境变量

创建一个 .env 文件，包含你的 Datadog 凭证：

DD_API_KEY=your_api_key_here
DD_APP_KEY=your_app_key_here
DD_SITE=datadoghq.com

命令行参数

datadog-mcp-server --apiKey=your_api_key --appKey=your_app_key --site=datadoghq.eu

注意：站点参数不需要 https:// - 会自动添加。

与 Claude Desktop 使用

将此内容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "datadog": {
      "command": "npx",
      "args": [
        "datadog-mcp-server",
        "--apiKey",
        "<YOUR_API_KEY>",
        "--appKey",
        "<YOUR_APP_KEY>",
        "--site",
        "<YOUR_SITE>"
      ]
    }
  }
}

与 Datadog 配合使用

将此内容添加到你的 ~/.config/datadog-mcp-server/config.json：

{
  "api_key": "<YOUR_API_KEY>",
  "app_key": "<YOUR_APP_KEY>",
  "site": "<YOUR_SITE>"
}

故障排除

如果你遇到 403 禁止错误，请验证以下几点：

1. 你的 API 密钥和应用程序密钥是正确的。
2. 这些密钥具有访问所请求资源的必要权限。
3. 你的账户对所请求的数据有访问权限。

调试

如果你遇到问题，检查 Claude Desktop 的 MCP 日志：

# 在 macOS 上
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

# 在 Windows 上
Get-Content -Path "$env:APPDATA\Claude\Logs\mcp*.log" -Tail 20 -Wait

常见问题：

• 403 禁止：Datadog API 密钥的身份验证问题。
• API 密钥或 App key 格式无效：确保使用完整的密钥字符串。
• 站点配置错误：确保你使用的 Datadog 域正确。

📄 许可证

本项目采用 MIT 许可证。