Datadog MCP 服务器

用于 Datadog API 的 MCP 服务器，支持事件管理等功能。

<a href="https://glama.ai/mcp/servers/bu8gtzkwfr"> <img width="380" height="200" src="https://glama.ai/mcp/servers/bu8gtzkwfr/badge" alt="mcp-server-datadog MCP server" /> </a>

功能

• 可观测性工具: 提供一种机制，通过 MCP 服务器利用关键的 Datadog 监控功能，例如事件、监视器、日志、仪表板和指标。
• 可扩展设计: 旨在轻松集成其他 Datadog API，从而实现无缝的未来功能扩展。

工具

1. list_incidents

   • 从 Datadog 检索事件列表。
   • 输入:
     • filter (可选字符串): 事件的过滤参数（例如，状态、优先级）。
     • pagination (可选对象): 分页详细信息，如页面大小/偏移量。
   • 返回: Datadog 事件数组和相关的元数据。

2. get_incident

   • 检索有关特定 Datadog 事件的详细信息。
   • 输入:
     • incident_id (字符串): 要获取详细信息的事件 ID。
   • 返回: 详细的事件信息（标题、状态、时间戳等）。

3. get_monitors

   • 获取 Datadog 监视器的状态。
   • 输入:
     • groupStates (可选数组): 要过滤的状态（例如，alert、warn、no data、ok）。
     • name (可选字符串): 按名称过滤。
     • tags (可选数组): 按标签过滤。
   • 返回: 监视器数据及其状态摘要。

4. get_logs

   • 搜索并从 Datadog 检索日志。
   • 输入:
     • query (字符串): Datadog 日志查询字符串。
     • from (数字): 开始时间，以 epoch 秒为单位。
     • to (数字): 结束时间，以 epoch 秒为单位。
     • limit (可选数字): 要返回的最大日志数（默认为 100）。
   • 返回: 匹配的日志数组。

5. list_dashboards

   • 从 Datadog 获取仪表板列表。
   • 输入:
     • name (可选字符串): 按名称过滤仪表板。
     • tags (可选数组): 按标签过滤仪表板。
   • 返回: 带有 URL 引用的仪表板数组。

6. get_dashboard

   • 从 Datadog 检索特定仪表板。
   • 输入:
     • dashboard_id (字符串): 要获取的仪表板的 ID。
   • 返回: 仪表板详细信息，包括标题、小部件等。

7. query_metrics

   • 从 Datadog 检索指标数据。
   • 输入:
     • query (字符串): 指标查询字符串。
     • from (数字): 开始时间，以 epoch 秒为单位。
     • to (数字): 结束时间，以 epoch 秒为单位。
   • 返回: 查询时间范围内的指标数据。

8. list_traces

   • 从 Datadog 检索 APM 追踪列表。
   • 输入:
     • query (字符串): Datadog APM 追踪查询字符串。
     • from (数字): 开始时间，以 epoch 秒为单位。
     • to (数字): 结束时间，以 epoch 秒为单位。
     • limit (可选数字): 要返回的最大追踪数（默认为 100）。
     • sort (可选字符串): 追踪的排序顺序（默认为 '-timestamp'）。
     • service (可选字符串): 按服务名称过滤。
     • operation (可选字符串): 按操作名称过滤。
   • 返回: 来自 Datadog APM 的匹配追踪数组。

9. list_hosts

   • 从 Datadog 获取主机列表。
   • 输入:
     • filter (可选字符串): 搜索结果的过滤字符串。
     • sort_field (可选字符串): 用于对主机进行排序的字段。
     • sort_dir (可选字符串): 排序方向 (asc/desc)。
     • start (可选数字): 分页的起始偏移量。
     • count (可选数字): 要返回的最大主机数（最大值：1000）。
     • from (可选数字): 从此 UNIX 时间戳搜索主机。
     • include_muted_hosts_data (可选布尔值): 包括静音主机状态和到期时间。
     • include_hosts_metadata (可选布尔值): 包括主机元数据（版本、平台等）。
   • 返回: 主机数组，包含名称、ID、别名、应用程序、静音状态等详细信息。

10. get_active_hosts_count

    • 获取 Datadog 中活动主机的总数。
    • 输入:
      • from (可选数字): 要获取活动主机总数的秒数（默认为 2 小时）。
    • 返回: 活动和正常运行的主机总数。

11. mute_host

    • 在 Datadog 中静音主机。
    • 输入:
      • hostname (字符串): 要静音的主机的名称。
      • message (可选字符串): 与此主机静音关联的消息。
      • end (可选数字): 静音应结束的 POSIX 时间戳。
      • override (可选布尔值): 如果为 true 且主机已静音，则替换现有结束时间。
    • 返回: 成功状态和确认消息。

12. unmute_host

    • 在 Datadog 中取消静音主机。
    • 输入:
      • hostname (字符串): 要取消静音的主机的名称。
    • 返回: 成功状态和确认消息。

13. list_downtimes

    • 列出 Datadog 中计划的停机时间。
    • 输入:
      • currentOnly (可选布尔值): 如果为 true，则仅返回当前活动的停机时间。
      • monitorId (可选数字): 按监视器 ID 过滤。
    • 返回: 计划的停机时间数组，包含范围、监视器信息和计划等详细信息。

14. schedule_downtime

    • 在 Datadog 中安排停机时间。
    • 输入:
      • scope (字符串): 应用停机时间的范围（例如 'host:my-host'）。
      • start (可选数字): 停机时间开始的 UNIX 时间戳。
      • end (可选数字): 停机时间结束的 UNIX 时间戳。
      • message (可选字符串): 要包含在停机时间中的消息。
      • timezone (可选字符串): 停机时间的时区（例如 'UTC'、'America/New_York'）。
      • monitorId (可选数字): 要静音的监视器的 ID。
      • monitorTags (可选数组): 用于过滤的监视器标签列表。
      • recurrence (可选对象): 停机时间的重复设置。
        • type (字符串): 重复类型（'days'、'weeks'、'months'、'years'）。
        • period (数字): 重复频率（必须 >= 1）。
        • weekDays (可选数组): 每周重复的星期几。
        • until (可选数字): 重复结束的 UNIX 时间戳。
    • 返回: 计划的停机时间详细信息，包括 ID 和活动状态。

15. cancel_downtime

    • 取消 Datadog 中计划的停机时间。
    • 输入:
      • downtimeId (数字): 要取消的停机时间的 ID。
    • 返回: 停机时间取消的确认。

设置

Datadog 凭据

您需要有效的 Datadog API 凭据才能使用此 MCP 服务器：

• DATADOG_API_KEY: 您的 Datadog API 密钥
• DATADOG_APP_KEY: 您的 Datadog 应用程序密钥
• DATADOG_SITE (可选): Datadog 站点（例如 datadoghq.eu）

在运行服务器之前，在您的环境中导出它们：

export DATADOG_API_KEY="your_api_key"
export DATADOG_APP_KEY="your_app_key"
export DATADOG_SITE="your_datadog_site"

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Datadog MCP 服务器：

npx -y @smithery/cli install @winor30/mcp-server-datadog --client claude

手动安装

pnpm install
pnpm build
pnpm watch   # 用于开发，具有自动重新构建功能

与 Claude Desktop 一起使用

要将其与 Claude Desktop 一起使用，请将以下内容添加到您的 claude_desktop_config.json：

在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

{
  "mcpServers": {
    "datadog": {
      "command": "/path/to/mcp-server-datadog/build/index.js",
      "env": {
        "DATADOG_API_KEY": "<YOUR_API_KEY>",
        "DATADOG_APP_KEY": "<YOUR_APP_KEY>",
        "DATADOG_SITE": "<YOUR_SITE>" // Optional
      }
    }
  }
}

或者通过 npx 指定：

{
  "mcpServers": {
    "mcp-server-datadog": {
      "command": "npx",
      "args": ["-y", "@winor30/mcp-server-datadog"],
      "env": {
        "DATADOG_API_KEY": "<YOUR_API_KEY>",
        "DATADOG_APP_KEY": "<YOUR_APP_KEY>",
        "DATADOG_SITE": "<YOUR_SITE>" // Optional
      }
    }
  }
}

调试

由于 MCP 服务器通过标准输入/输出进行通信，因此调试有时会很棘手。 我们建议使用 MCP Inspector。 您可以使用以下命令运行检查器：

npm run inspector

检查器将提供一个 URL，您可以在浏览器中打开该 URL 以查看日志并手动发送请求。

贡献

欢迎贡献！ 如果您有任何建议、错误报告或改进建议，请随时打开 issue 或 pull request。

许可证

本项目根据 Apache License, Version 2.0 获得许可。