使用说明

项目简介

Datadog MCP Server 是一个 MCP 服务器实现，它扩展了大型语言模型（LLM）的能力，使其能够安全地访问和利用 Datadog 监控平台的数据。通过此服务器，LLM 可以调用预定义的工具来查询 Datadog 的监控指标、日志、事件、仪表板和告警等信息，从而实现更智能的应用集成和自动化运维。

主要功能点

监控数据访问: 提供工具检索 Datadog 监控器 (Monitors) 的状态和配置。
仪表板数据访问: 支持获取 Datadog 仪表板 (Dashboards) 的定义和列表。
指标数据查询: 允许查询 Datadog 指标 (Metrics) 以及其元数据信息。
事件数据检索: 可以搜索和检索 Datadog 事件 (Events)，例如部署、告警等。
日志数据分析: 提供高级日志搜索 (Logs Search) 和聚合 (Logs Aggregate) 功能，支持复杂的查询和分析需求。
事件管理: 支持访问 Datadog 事件管理 (Incidents) 数据。
Datadog API 集成: 直接与 Datadog v1 和 v2 API 集成，保证数据访问的实时性和准确性。
完善的错误处理: 提供清晰的错误信息，帮助用户快速定位和解决 API 和认证问题。

安装步骤

安装 Node.js: 确保您的系统已安装 Node.js (版本 16 或更高)。

全局安装 Datadog MCP Server: 打开终端，运行以下命令进行全局安装：

npm install -g datadog-mcp-server

服务器配置

要将 Datadog MCP Server 集成到 MCP 客户端（例如 Claude Desktop），您需要配置客户端的 MCP 服务器设置。以下是配置 Claude Desktop 的 'claude_desktop_config.json' 文件的示例配置：

{
  "mcpServers": {
    "datadog": {
      "command": "npx",
      "args": [
        "datadog-mcp-server",
        "--apiKey",
        "<您的 Datadog API 密钥>",
        "--appKey",
        "<您的 Datadog 应用程序密钥>",
        "--site",
        "<您的 Datadog 站点域名，例如 datadoghq.com>"
      ]
    }
  }
}

配置参数说明:

server name: 'datadog' (服务器名称，在客户端配置中用于标识此服务器).
command: 'npx' (运行命令，通常为 'npx' 或 Node.js 可执行文件的路径).
args: 启动服务器所需的参数列表，包括：
- '--apiKey': 您的 Datadog API 密钥。您可以在 Datadog 后台的 "Organization Settings > API Keys" 中找到。
- '--appKey': 您的 Datadog 应用程序密钥。您可以在 Datadog 后台的 "Organization Settings > Application Keys" 中找到。
- '--site': 您的 Datadog 站点域名，例如 'datadoghq.com' 或 'datadoghq.eu'。请根据您的 Datadog 账户所在区域填写。

请务必替换 '<您的 Datadog API 密钥>'、'<您的 Datadog 应用程序密钥>' 和 '<您的 Datadog 站点域名，例如 datadoghq.com>' 为您真实的 Datadog 密钥和站点信息。

基本使用方法

配置完成后，您的 MCP 客户端（如 Claude Desktop）将能够通过 "datadog" 服务器访问 Datadog 数据。您可以使用客户端提供的界面或指令，调用以下工具来与 Datadog 交互：

'get-monitors': 获取监控器列表
'get-monitor': 获取指定监控器的详细信息
'get-dashboards': 获取仪表板列表
'get-dashboard': 获取指定仪表板的详细信息
'get-metrics': 获取可用指标列表
'get-metric-metadata': 获取指定指标的元数据
'get-events': 获取事件列表
'get-incidents': 获取事件列表
'search-logs': 搜索日志
'aggregate-logs': 聚合日志

具体的工具调用方法和参数，请参考 MCP 客户端的文档和工具描述。通常，您需要构造符合 MCP 协议的 JSON-RPC 请求，指定要调用的工具名称和参数。示例请求可以在仓库的 README.md 文件中找到。

例如，要获取告警状态的监控器列表，您可以发送如下格式的请求：

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

请根据您的具体需求，选择合适的工具并配置正确的参数。

关键词