MCP Cloudwatch Tracker

🚀 クラウドウォッチログトラッカー

AWS CloudWatch ログの分析とデバッグに使用する MCP（モデルコンテキストプロトコル）サーバーです。

✨ 主な機能

• CloudWatch ロググループから特定の文字列を検索します。
• ログの前後のコンテキストを表示します。
• ログ分析結果の要約を提供します。
• エラーログの分析と原因の特定を行います。

📦 インストール

NPX を使用して実行

npx -y @juri-dev-lab/mcp-cloudwatch-tracker@latest \
  --aws-access-key-id あなたの AWS アクセスキー ID \
  --aws-secret-access-key あなたの AWS シークレットキー \
  --aws-region あなたの AWS リージョン

Docker を使用して実行

# Docker Hub からイメージをダウンロード
docker pull juridevlab/mcp-cloudwatch-tracker

# 環境変数を設定して実行
docker run --rm -i \
  -e AWS_ACCESS_KEY_ID=あなたの AWS アクセスキー ID \
  -e AWS_SECRET_ACCESS_KEY=あなたの AWS シークレットキー \
  -e AWS_REGION=あなたの AWS リージョン \
  juridevlab/mcp-cloudwatch-tracker

AWS クレデンシャルの設定

以下のいずれかの方法を使用して AWS クレデンシャルを設定してください。

1. .env ファイルを使用する（開発環境で推奨）

# プロジェクトのルートディレクトリに .env ファイルを作成
AWS_ACCESS_KEY_ID=your_access_key
AWS_SECRET_ACCESS_KEY=your_secret_key
AWS_REGION=ap-northeast-2

2. システム環境変数を使用する

export AWS_ACCESS_KEY_ID=あなたの AWS アクセスキー ID
export AWS_SECRET_ACCESS_KEY=あなたの AWS シークレットキー
export AWS_REGION=ap-northeast-2

3. AWS CLI を使用してクレデンシャルを設定する

aws configure

⚠️ 重要提示

• .env ファイルを使用する場合は、必ず .gitignore に追加してください。
• AWS クレデンシャルをソースコードやバージョン管理システムに含めないでください。
• それぞれ独立した AWS アカウントのクレデンシャルを使用してください。
• 本番環境では AWS IAM ロールの使用をおすすめします。

推奨される IAM ポリシー

CloudWatch ログにアクセスするために必要な最小限の権限ポリシーです。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "logs:GetLogEvents",
        "logs:FilterLogEvents",
        "logs:DescribeLogGroups",
        "logs:DescribeLogStreams"
      ],
      "Resource": "arn:aws:logs:*:*:*"
    }
  ]
}

💻 使用例

基本的な使用法

# キーワードを含むエントリを検索
$ tracker search --keyword "キーワード" --log-group /var/log/myapp.log

# 条件でログをフィルタリング
$ tracker filter --start-time "2023-10-01" --end-time "2023-10-02"

高度な使用法

# 最新の 10 件のログを表示
$ tracker latest --limit 10

開発環境の設定

リポジトリをクローンする

git clone https://github.com/your-repository/mcp-cloudwatch-tracker.git
cd mcp-cloudwatch-tracker

依存関係をインストールする

npm install

サーバーを起動する

node index.js

テスト

単体テスト

npm test

ウォッチモード

npm run watch

📄 ライセンス

MIT