What is Cloudrun Logs Mcp

cloudrun-logs-mcp is a tool designed to access and view Google Cloud Run logs through the Model Context Protocol (MCP) interface.

Use cases

Use cases include retrieving logs for debugging applications, monitoring service performance, and integrating with AI assistants to provide real-time log data.

How to use

To use cloudrun-logs-mcp, authenticate using Google Cloud application default credentials, then filter logs by project ID, service name, time range, log level, and keywords. You can run the tool directly or set it up as an MCP server.

Key features

Key features include authentication using Google Cloud application default credentials, filtering options for logs, and output in either text or JSON format.

Where to use

cloudrun-logs-mcp is used in cloud computing environments, particularly for applications running on Google Cloud Run, where monitoring and logging are essential.

Cloud Run Logs MCP

Google Cloud RunのログをMCPのインターフェースを介して確認するためのツールです。

機能

• Google Cloudのアプリケーションデフォルトクレデンシャルを使用して認証
• プロジェクトID、サービス名、時間範囲、ログレベル、キーワードなどでフィルタリング
• テキスト形式またはJSON形式での出力

前提条件

このツールは、Google Cloudのアプリケーションデフォルトクレデンシャルを使用して認証を行います。以下のいずれかの方法で認証情報を設定してください：

1. gcloud auth application-default loginコマンドを実行
2. GOOGLE_APPLICATION_CREDENTIALS環境変数にサービスアカウントキーのパスを設定
3. Google Cloud環境（Compute Engine、Cloud Run、GKEなど）で実行する場合は、自動的に認証情報が提供されます

MCPサーバーとしての使用

このツールは、Model Context Protocol (MCP) サーバーとしても機能します。MCPサーバーを使用すると、AIアシスタントがCloud Runのログやサービス情報を直接取得できるようになります。

MCPサーバーの設定(バイナリをダウンロードする場合)

GitHubのリリースページからバイナリをダウンロードして使用することもできます。
https://github.com/maito1201/cloudrun-logs-mcp/releases

macOS(Apple Silicon)

curl -L https://github.com/maito1201/cloudrun-logs-mcp/releases/latest/download/cloudrun-logs-mcp_Darwin_arm64.tar.gz -o cloudrun-logs-mcp.tar.gz

macOS(Intel)

curl -L https://github.com/maito1201/cloudrun-logs-mcp/releases/latest/download/cloudrun-logs-mcp_Darwin_x86_64.tar.gz -o cloudrun-logs-mcp.tar.gz

# 解凍
tar -xzf cloudrun-logs-mcp.tar.gz

# 実行権限を付与
chmod +x cloudrun-logs-mcp

# 必要に応じて、パスの通った場所に移動
# 例：
# sudo mv cloudrun-logs-mcp /usr/local/bin/

MCPサーバーの設定(Clineの場合)

{
  "mcpServers": {
    "cloudrun-logs": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "command": "/your-installed-path/cloudrun-logs-mcp",
      "args": [],
      "transportType": "stdio"
    }
  }
}

MCPサーバーの設定(ビルドする場合)

# リポジトリをクローンしてビルド
git clone https://github.com/maito1201/cloudrun-logs-mcp.git
cd cloudrun-logs-mcp
go build

MCPサーバーの設定(Clineの場合)

{
  "mcpServers": {
    "cloudrun-logs": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "command": "/your-build-path/cloudrun-logs-mcp",
      "args": [],
      "transportType": "stdio"
    }
  }
}

MCPサーバーの設定(go install)

go install github.com/maito1201/cloudrun-logs-mcp@latest

MCPサーバーの設定(Clineの場合)

{
  "mcpServers": {
    "cloudrun-logs": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "command": "cloudrun-logs-mcp",
      "args": [],
      "transportType": "stdio"
    }
  }
}

利用可能なツール

MCPサーバーは以下のツールを提供します：

get_logs

Google Cloud Runのログを取得します。

パラメータ：

使用例：

{
  "project_id": "your-project-id",
  "service_name": "your-service-name",
  "log_level": "ERROR",
  "keywords": [
    "error",
    "exception"
  ],
  "limit": 50
}

get_services

Google Cloud Runのサービス一覧を取得します。

パラメータ：

使用例：

{
  "project_id": "your-project-id",
  "region": "us-central1"
}

AIアシスタントとの連携

AIアシスタントとMCPサーバーを連携するには、以下の手順を実行します：

1. MCPサーバーを起動します
2. AIアシスタントにMCPサーバーのURLを提供します（例：http://localhost:3000）
3. AIアシスタントがMCPサーバーを通じてCloud Runのログやサービス情報を取得できるようになります

使用例

AIアシスタントとの対話例：

ユーザー: project-idが「my-project」のCloud Runサービス一覧を取得してください

AIアシスタント: Cloud Runサービス一覧を取得します。

[AIアシスタントがMCPサーバーを使用してサービス一覧を取得]

以下がプロジェクト「my-project」のCloud Runサービス一覧です：

名前: service-1
URL: https://service-1-xxx.run.app
ステータス: Ready
作成日時: 2023-01-01T00:00:00Z

名前: service-2
URL: https://service-2-xxx.run.app
ステータス: Ready
作成日時: 2023-01-02T00:00:00Z

合計2件のサービスが見つかりました。

CLIツールとしての使用

CLIツールとして本機能を利用可能です。
以下の2つのコマンドがあります：

• logs: Cloud Runのログを取得
• services: Cloud Runのサービス一覧を取得

ログの取得

# 基本的な使い方（プロジェクトIDは必須）
./cloudrun-logs logs --project=your-project-id

# サービス名を指定
./cloudrun-logs logs --project=your-project-id --service=your-service-name

# 時間範囲を指定
./cloudrun-logs logs --project=your-project-id --start-time=2023-01-01T00:00:00Z --end-time=2023-01-02T00:00:00Z

# ログレベルを指定
./cloudrun-logs logs --project=your-project-id --level=ERROR

# キーワードで検索
./cloudrun-logs logs --project=your-project-id --keyword=error --keyword=exception

# 取得するログエントリの最大数を指定
./cloudrun-logs logs --project=your-project-id --limit=50

# JSON形式で出力
./cloudrun-logs logs --project=your-project-id --json

サービス一覧の取得

# 基本的な使い方（プロジェクトIDは必須）
./cloudrun-logs services --project=your-project-id

# リージョンを指定
./cloudrun-logs services --project=your-project-id --region=us-central1

# JSON形式で出力
./cloudrun-logs services --project=your-project-id --json

オプション一覧

logsコマンドのオプション

servicesコマンドのオプション

ライブラリとしての使用

このツールは、ライブラリとしても使用できます。以下は使用例です：

ログの取得

package main

import (
	"context"
	"fmt"
	"time"

	"github.com/maito1201/cloudrun-logs-mcp/logs"
)

func main() {
	// フィルターオプションを設定
	opts := logs.FilterOptions{
		ProjectID:   "your-project-id",
		ServiceName: "your-service-name",
		StartTime:   time.Now().Add(-24 * time.Hour), // 24時間前から
		LogLevel:    "ERROR",
		Keywords:    []string{"error", "exception"},
		Limit:       50,
	}

	// ログを取得
	ctx := context.Background()
	entries, err := logs.GetCloudRunLogs(ctx, opts)
	if err != nil {
		fmt.Printf("エラー: %v\n", err)
		return
	}

	// 結果を処理
	for _, entry := range entries {
		fmt.Printf("[%s] %s: %s\n", entry.Timestamp.Format(time.RFC3339), entry.Severity, entry.Message)
	}
}

サービス一覧の取得

package main

import (
	"context"
	"fmt"
	"time"

	"github.com/maito1201/cloudrun-logs-mcp/logs"
)

func main() {
	// プロジェクトIDとリージョンを指定
	projectID := "your-project-id"
	region := "us-central1"

	// サービス一覧を取得
	ctx := context.Background()
	services, err := logs.GetCloudRunServices(ctx, projectID, region)
	if err != nil {
		fmt.Printf("エラー: %v\n", err)
		return
	}

	// 結果を処理
	for _, service := range services {
		fmt.Printf("名前: %s\n", service.Name)
		if service.Description != "" {
			fmt.Printf("説明: %s\n", service.Description)
		}
		fmt.Printf("URL: %s\n", service.URL)
		fmt.Printf("ステータス: %s\n", service.Status)
		fmt.Printf("作成日時: %s\n", service.CreateTime.Format(time.RFC3339))
		fmt.Printf("更新日時: %s\n", service.UpdateTime.Format(time.RFC3339))
		fmt.Println()
	}
}

ライセンス

MIT