DataDog MCP 服务器

@GeLi2001/datadog-mcp-server

0 Stars 303 次浏览 GeLi2001 更新于 2026-08-23

用于追踪和监控

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "datadog": {
      "args": [
        "datadog-mcp-server",
        "--apiKey",
        "\u003cYOUR_API_KEY\u003e",
        "--appKey",
        "\u003cYOUR_APP_KEY\u003e",
        "--site",
        "\u003cYOUR_DD_SITE\u003e(e.g us5.datadoghq.com)"
      ],
      "command": "npx"
    }
  }
}

该服务需要配置环境变量：DD_API_KEY、DD_APP_KEY、DD_SITE

服务介绍

Datadog MCP 服务器

一个用于与 Datadog API 交互的 Model Context Protocol (MCP) 服务器。

功能

监控：访问监控数据和配置
仪表盘：检索并查看仪表盘定义
指标：查询可用指标及其元数据
事件：在指定时间范围内搜索和检索事件
日志：使用高级过滤和排序选项搜索日志
事件管理：访问事件管理数据
API 集成：直接集成 Datadog 的 v1 和 v2 API
全面的错误处理：对 API 和认证问题提供清晰的错误信息

前提条件

Node.js（版本 16 或更高）
Datadog 账户，包含：
- API 密钥 - 在组织设置 > API 密钥中找到
- 应用密钥 - 在组织设置 > 应用密钥中找到

安装

通过 npm（推荐）

npm install -g datadog-mcp-server

从源代码安装

克隆此仓库
安装依赖项：
```
npm install
```
构建项目：
```
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_DD_SITE>(e.g us5.datadoghq.com)"
      ]
    }
  }
}

Claude Desktop 配置文件的位置：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

使用 MCP 检查器

要与 MCP 检查器工具一起使用，请执行：

npx @modelcontextprotocol/inspector datadog-mcp-server --apiKey=your_api_key --appKey=your_app_key

可用工具

该服务器提供了这些 MCP 工具：

get-monitors: 获取监控器，可选过滤
get-monitor: 根据 ID 获取特定监控器的详细信息
get-dashboards: 列出所有仪表盘
get-dashboard: 根据 ID 获取特定仪表盘
get-metrics: 列出可用指标
get-metric-metadata: 获取特定指标的元数据
get-events: 在指定时间范围内获取事件
get-incidents: 列出事件，可选过滤
search-logs: 使用高级查询过滤搜索日志
aggregate-logs: 对日志数据进行分析和聚合

示例

示例：获取监控器

{
  "method": "tools/call",
  "params": {
    "name": "get-monitors",
    "arguments": {
      "groupStates": ["alert", "warn"],
      "limit": 5
    }
  }
}

示例：获取仪表盘

{
  "method": "tools/call",
  "params": {
    "name": "get-dashboard",
    "arguments": {
      "dashboardId": "abc-def-123"
    }
  }
}

示例：搜索日志

{
  "method": "tools/call",
  "params": {
    "name": "search-logs",
    "arguments": {
      "filter": {
        "query": "service:web-app status:error",
        "from": "now-15m",
        "to": "now"
      },
      "sort": "-timestamp",
      "limit": 20
    }
  }
}

示例：聚合日志

{
  "method": "tools/call",
  "params": {
    "name": "aggregate-logs",
    "arguments": {
      "filter": {
        "query": "service:web-app",
        "from": "now-1h",
        "to": "now"
      },
      "compute": [
        {
          "aggregation": "count"
        }
      ],
      "groupBy": [
        {
          "facet": "status",
          "limit": 10,
          "sort": {
            "aggregation": "count",
            "order": "desc"
          }
        }
      ]
    }
  }
}

示例：获取事件

{
  "method": "tools/call",
  "params": {
    "name": "get-incidents",
    "arguments": {
      "includeArchived": false,
      "query": "state:active",
      "pageSize": 10
    }
  }
}

故障排除

如果您遇到 403 Forbidden 错误，请验证：

您的 API 密钥和应用程序密钥是正确的
这些密钥具有访问请求资源所需的权限
您的账户可以访问所请求的数据

调试

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

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

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

常见问题：

403 Forbidden：Datadog API 密钥的身份验证问题
API 密钥或应用密钥格式无效：确保您使用的是完整的密钥字符串
站点配置错误：确保您使用的是正确的 Datadog 域名

许可证

MIT

查看源码项目主页