CloudWatch Logs MCP Server

CloudWatch Logs MCP サーバー

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

利用可能なツール

list_groups

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

パラメータ:

• prefix（省略可能）: ロググループ名のプレフィックス
• region（省略可能）: AWS リージョン
• accessKeyId（省略可能）: AWS アクセスキー ID
• secretAccessKey（省略可能）: AWS シークレットアクセスキー
• sessionToken（省略可能）: AWS セッショントークン

戻り値: ロググループの一覧を含む JSON 文字列。logGroupName、creationTime、storedBytes が含まれます。

get_logs

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

パラメータ:

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

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

セットアップ

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() でデコレートされた async 関数として実装されています。サーバーは boto3 ライブラリを使用して AWS CloudWatch Logs API とやり取りします。

ライセンス

MIT