Datadog MCP 服务器

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

功能

• 监控: 访问监控数据和配置
• 仪表板: 获取和查看仪表板定义
• 指标: 查询可用指标及其元数据
• 事件: 在时间段内搜索和检索事件
• 日志: 使用高级过滤和排序选项搜索日志
• 事故: 访问事故管理数据
• API 集成: 直接与 Datadog 的 v1 和 v2 API 集成
• 全面错误处理: 清楚的错误消息，针对 API 和身份验证问题

先决条件

1. Node.js (版本 16 或更高)
2. Datadog 账户，具有：
   • 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