Datadog MCP サーバー

Datadog API と対話するためのモデルコンテキストプロトコル (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 サーバーを構成できます。

環境変数

Datadog の認証情報を使用して.envファイルを作成します。

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 Inspector での使用

MCP Inspector ツールで使用するには:

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 : 高度なクエリフィルタリングによるログの検索
集計ログ: ログデータの分析と集計を実行する

例

例: モニターを取得する

{
  "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 ドメインを使用していることを確認してください

ライセンス

マサチューセッツ工科大学

datadog mcp

Integrations