Cloudwatch Logs MCP

🚀 CloudWatchログMCPサーバー

このサーバーは、AWS CloudWatchログにアクセスするためのツールを提供するMCP（モデルコンテキストプロトコル）サーバーです。AIアシスタントがCloudWatchロググループをリストし、AWS CloudWatchからログエントリを読み取ることを可能にします。

✨ 主な機能

list_groups

利用可能なCloudWatchロググループをリストします。

パラメータ：

• prefix（オプション）：ロググループ名の接頭辞
• region（オプション）：AWSリージョン
• accessKeyId（オプション）：AWSアクセスキーID
• secretAccessKey（オプション）：AWSシークレットアクセスキー
• sessionToken（オプション）：AWSセッショントークン

戻り値： logGroupName、creationTime、storedBytesを含むJSON文字列。

get_logs

特定のロググループから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

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 SDKのFastMCPクラスを使用して構築されています。このクラスは、MCPサーバーを簡単に作成する方法を提供します。サーバーは主に2つのツールを公開しています。

1. list_groups：利用可能なCloudWatchロググループをリストする
2. get_logs：特定のロググループからログエントリを読み取る

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

📄 ライセンス

MITライセンス