Datadog MCP Server

Datadog MCP Server

Datadog MCP Server 是一個輕量級伺服器實作，提供 Datadog 的監控、儀表板、指標、日誌和事件管理 API，以標準化的 MCP 工具形式，讓 LLM 驅動的應用程式和代理可以安全地與 Datadog 資源互動，並透過模型上下文協議執行動態操作。

Author: GeLi2001


查看協議

什麼是 Datadog MCP Server？

Datadog MCP Server 是一個專用的模型上下文協議 (MCP) 伺服器，它作為 AI 驅動的代理或 LLM 驅動應用程式與 Datadog API 之間的橋樑。通過提供一套映射到 Datadog 監控、指標、儀表板、事件、日誌和事件管理功能的 MCP 工具，這個伺服器使得與 Datadog 數據的標準化、安全和動態互動成為可能，支持在 AI 系統內進行簡化工作流程、自動故障排除和增強可觀察性任務。

如何配置

要配置 Datadog MCP Server，您需要：

  • Node.js (版本 16 以上)
  • Datadog API 和應用金鑰

1. 使用環境變數設置憑證：

創建一個 .env 文件：

DD_API_KEY=你的_api_key
DD_APP_KEY=你的_app_key
DD_SITE=datadoghq.com
DD_LOGS_SITE=datadoghq.com   # 可選
DD_METRICS_SITE=datadoghq.com   # 可選

或

2. 作為命令行參數提供憑證：

datadog-mcp-server --apiKey=你的_api_key --appKey=你的_app_key --site=datadoghq.com
  • 對於多區域或特定服務的域名，根據需要使用 --logsSite 和 --metricsSite。
  • 如果與 Claude Desktop 連線，請將配置寫入 claude_desktop_config.json（位置因操作系統而異）。使用全球站點或指定 logsSite/metricsSite 以進行更精細的設置。

如何使用

  1. 安裝

    npm install -g datadog-mcp-server

    或通過 npx 直接運行。

  2. 啟動伺服器

    datadog-mcp-server --apiKey=你的_API_KEY --appKey=你的_APP_KEY --site=你的_DD_SITE

    或依賴你的環境變數 (.env)。

  3. 與你的 AI 代理、MCP 客戶端或像 Claude Desktop 或 MCP Inspector 的工具整合。

    • 配置 Claude Desktop 的配置文件以啟動此伺服器（參見上文）。
    • 或運行檢查器以進行手動探索： 
      npx @modelcontextprotocol/inspector datadog-mcp-server --apiKey=你的_api_key --appKey=你的_app_key

  4. 訪問工具

    • 使用 MCP 協議的 /tools/list 端點來發現可用功能。
    • 通過 /tools/call 端點調用動作，傳遞參數（見示例）。

主要特點

  • 完整覆蓋 Datadog 的監控、儀表板、指標、事件、日誌和事件 API 透過 MCP 工具
  • 安全的憑證配置和最佳數據處理
  • 全球和區域特定的 Datadog 站點的靈活端點配置
  • 可執行的 MCP 工具，用於獲取監視器、儀表板、事件和日誌，以及進階日誌搜索和聚合
  • 綜合的錯誤處理和清晰的 API 或身份驗證問題訊息
  • 與 AI 助手、Claude Desktop 或自定義 MCP 客戶端的即插即用整合
  • 輕量且容易在本地機器或伺服器上部署

使用案例

  • AI 代理或協助者從 Datadog 直接顯示監控數據和儀表板
  • 自動化事件管理助手按需檢索上下文並顯示事件或相關日誌
  • 可以通過自然語言請求在 LLM 驅動的工作流程中獲取、過濾和聚合警報和日誌
  • 按需指標探索和儀表板檢索用於故障排除或報告
  • 通過 MCP 兼容 UI 立即查詢和可視化最近的應用程序錯誤、狀態或異常

常見問題

Q1: 當我運行伺服器時出現 403 Forbidden 錯誤。

  • 確保 API 金鑰和應用金鑰都是有效的，屬於正確的 Datadog 帳戶，擁有所需的權限，且正確設置為環境變數或命令行參數。同時，確認端點（--site）與你的 Datadog 區域相符。

Q2: 我該如何將伺服器連接到 Claude Desktop 或類似的代理？

  • 配置 claude_desktop_config.json，添加 Datadog MCP 伺服器條目，指定命令和參數，並使用你的 Datadog 憑證和區域。確保你的金鑰和端點是正確的。

Q3: 我可以為 Datadog 日誌和指標使用不同的端點嗎？

  • 可以。通過命令行參數或環境變數 (DD_LOGS_SITE, DD_METRICS_SITE) 指定 --logsSite 和 --metricsSite。這對於每個服務有專用端點的組織特別有用。

Q4: 在我的本地機器上運行這個伺服器是否安全？

  • 是的，Datadog MCP Server 設計為安全的本地部署。金鑰從環境變數或參數中讀取，不會在其他地方持久保存。始終保持你的憑證安全。

Q5: 如果我的查詢沒有返回結果或似乎不正確，我該怎麼辦？

  • 檢查查詢的語法和過濾條件（例如，時間範圍、狀態、服務名稱）。確保你的金鑰有權限訪問相關數據，同時設置的端點與數據所在區域匹配。