CloudWatch Logs MCP サーバー

AWS CloudWatch ログにアクセスするためのツールを提供する MCP（Model Context Protocol）サーバー。このサーバーにより、AI アシスタントはロググループを一覧表示し、AWS CloudWatch からログエントリを読み取ることができます。

利用可能なツール

リストグループ

利用可能な CloudWatch ロググループを一覧表示します。

パラメータ:

prefix （オプション）：ロググループ名のプレフィックス
region （オプション）: AWS リージョン
accessKeyId (オプション): AWS アクセスキー ID
secretAccessKey (オプション): AWS シークレットアクセスキー
sessionToken (オプション): AWSセッショントークン

戻り値: logGroupName 、 creationTime 、 storedBytesを含むロググループのリストを含む JSON 文字列。

ログを取得する

特定のロググループから CloudWatch ログを取得します。

パラメータ:

logGroupName (必須): ロググループの名前
logStreamName (オプション): ログストリームの名前
startTime (オプション): ISO 形式または相対時間での開始時刻 (例: "5m"、"1h"、"1d")
endTime (オプション): ISO 形式の終了時刻
filterPattern (オプション): ログのフィルターパターン
region （オプション）: AWS リージョン
accessKeyId (オプション): AWS アクセスキー ID
secretAccessKey (オプション): AWS シークレットアクセスキー
sessionToken (オプション): AWSセッショントークン

戻り値: timestamp 、 message 、 logStreamNameを含むログイベントを含む JSON 文字列。

設定

AWS 認証情報

AWS 認証情報が設定されていることを確認してください。AWS CLI を使用するか、環境変数を設定することで設定できます。

AWS_ACCESS_KEY_ID
AWS_SECRET_ACCESS_KEY

Claude Desktopでの使用

claude_desktop_config.jsonに以下を追加します。

{
  "mcpServers": {
    "cloudwatch-logs": {
      "command": "python3",
      "args": ["/path/to/cloudwatch-logs-mcp/main.py"],
      "env": {
        "AWS_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY_ID>",
        "AWS_SECRET_ACCESS_KEY": "<YOUR_SECRET_ACCESS_KEY>",
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

ドッカー

Docker コンテナ内でサーバーを実行する場合は、Dockerfile をセットアップして次の構成を使用できます。

{
  "mcpServers": {
    "cloudwatch-logs": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "AWS_ACCESS_KEY_ID",
        "-e",
        "AWS_SECRET_ACCESS_KEY",
        "mcp/cloudwatch-logs"
      ],
      "env": {
        "AWS_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY_ID>",
        "AWS_SECRET_ACCESS_KEY": "<YOUR_SECRET_ACCESS_KEY>",
      }
    }
  }
}

実装の詳細

このサーバーは、MCPサーバーを簡単に作成できるMCP SDKのFastMCPクラスを使用して構築されています。このサーバーは、主に2つのツールを公開しています。

list_groups : 利用可能な CloudWatch ロググループを一覧表示します
get_logs : 特定のロググループからログエントリを読み取ります

各ツールは@mcp.tool()で修飾された非同期関数として実装されています。サーバーはboto3ライブラリを使用してAWS CloudWatch Logs APIとやり取りします。

ライセンス

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

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

ロググループを一覧表示し、ログエントリを読み取ることで、AI アシスタントが AWS CloudWatch ログにアクセスできるようにする MCP サーバー。

CloudWatch Logs MCP Server