Datadog MCP サーバー

インシデント管理などを可能にする、Datadog API 用の MCP サーバー。

特徴

• 観測可能性ツール: MCP サーバーを通じて、インシデント、モニター、ログ、ダッシュボード、メトリックなどの主要な Datadog 監視機能を活用するためのメカニズムを提供します。
• 拡張可能な設計: 追加の Datadog API と簡単に統合できるように設計されており、将来の機能拡張をシームレスに行うことができます。

ツール

1. list_incidents
   • Datadog からインシデントのリストを取得します。
   • 入力:
     • filter (オプションの文字列): インシデントのフィルターパラメータ (例: ステータス、優先度)。
     • pagination (オプション オブジェクト): ページ サイズやオフセットなどのページ区切りの詳細。
   • 戻り値: Datadog インシデントおよび関連メタデータの配列。
2. get_incident
   • 特定の Datadog インシデントに関する詳細情報を取得します。
   • 入力:
     • incident_id (文字列): 詳細を取得するインシデント ID。
   • 返されるもの: 詳細なインシデント情報 (タイトル、ステータス、タイムスタンプなど)。
3. get_monitors
   • Datadog モニターのステータスを取得します。
   • 入力:
     • groupStates (オプションの配列): フィルタリングする状態 (例: アラート、警告、データなし、OK)。
     • name (オプションの文字列): 名前でフィルタリングします。
     • tags (オプションの配列): タグでフィルタリングします。
   • 戻り値: モニターのデータとそのステータスの概要。
4. get_logs
   • Datadog からログを検索して取得します。
   • 入力:
     • query (文字列): Datadog はクエリ文字列を記録します。
     • from (数値): エポック秒単位での開始時刻。
     • to (数値): エポック秒単位での終了時間。
     • limit (オプションの数値): 返されるログの最大数 (デフォルトは 100)。
   • 戻り値: 一致するログの配列。
5. list_dashboards
   • Datadog からダッシュボードのリストを取得します。
   • 入力:
     • name (オプションの文字列): ダッシュボードを名前でフィルタリングします。
     • tags (オプションの配列): タグでダッシュボードをフィルタリングします。
   • 戻り値: URL 参照を含むダッシュボードの配列。
6. get_dashboard
   • Datadog から特定のダッシュボードを取得します。
   • 入力:
     • dashboard_id (文字列): 取得するダッシュボードの ID。
   • 戻り値: タイトル、ウィジェットなどのダッシュボードの詳細。
7. get_metrics
   • Datadog からメトリクス データを取得します。
   • 入力:
     • query (文字列): メトリクスクエリ文字列。
     • from (数値): エポック秒単位での開始時刻。
     • to (数値): エポック秒単位での終了時間。
   • 戻り値: 照会された時間枠のメトリック データ。
8. list_traces
   • Datadog から APM トレースのリストを取得します。
   • 入力:
     • query (文字列): Datadog APM トレース クエリ文字列。
     • from (数値): エポック秒単位での開始時刻。
     • to (数値): エポック秒単位での終了時間。
     • limit (オプションの数値): 返されるトレースの最大数 (デフォルトは 100)。
     • sort (オプションの文字列): トレースのソート順序 (デフォルトは '-timestamp')。
     • service (オプションの文字列): サービス名でフィルタリングします。
     • operation (オプションの文字列): 操作名でフィルタリングします。
   • 戻り値: Datadog APM からの一致するトレースの配列。
9. list_hosts
   • Datadog からホストのリストを取得します。
   • 入力:
     • filter (オプションの文字列): 検索結果のフィルター文字列。
     • sort_field (オプションの文字列): ホストを並べ替えるフィールド。
     • sort_dir (オプションの文字列): 並べ替えの方向 (昇順/降順)。
     • 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 の認証情報

この MCP サーバーを使用するには、有効な Datadog API 認証情報が必要です。

• DATADOG_API_KEY : Datadog APIキー
• DATADOG_APP_KEY : Datadog アプリケーションキー
• DATADOG_SITE (オプション): Datadog サイト (例: datadoghq.eu )

サーバーを実行する前に、それらを環境にエクスポートします。

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Datadog MCP Server を自動的にインストールするには:

手動インストール

Claude Desktopでの使用

Claude Desktop でこれを使用するには、 claude_desktop_config.jsonに以下を追加します。

MacOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

またはnpxで指定します:

デバッグ

MCPサーバーは標準入出力を介して通信するため、デバッグが難しくなる場合があります。MCP Inspector の使用をお勧めします。Inspectorは次のコマンドで実行できます。

インスペクターは、ブラウザで開いてログを表示したり、リクエストを手動で送信したりできる URL を提供します。

貢献

貢献を歓迎します！ご提案、バグ報告、改善提案などございましたら、お気軽に問題報告またはプルリクエストをご提出ください。

ライセンス

このプロジェクトは、Apache License バージョン 2.0に基づいてライセンスされます。