READMEmain
We couldn't render this README. Read it on GitHub
Cloud Run Logs MCP
Google Cloud RunのログをMCPのインターフェースを介して確認するためのツールです。
機能
- Google Cloudのアプリケーションデフォルトクレデンシャルを使用して認証
- プロジェクトID、サービス名、時間範囲、ログレベル、キーワードなどでフィルタリング
- テキスト形式またはJSON形式での出力
前提条件
このツールは、Google Cloudのアプリケーションデフォルトクレデンシャルを使用して認証を行います。以下のいずれかの方法で認証情報を設定してください：
gcloud auth application-default loginコマンドを実行- GOOGLE_APPLICATION_CREDENTIALS環境変数にサービスアカウントキーのパスを設定
- 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 | Google Cloudプロジェクトのプロジェクトid | はい | - |
| service_name | Cloud Runのサービス名 | いいえ | - |
| start_time | ログの開始時間（RFC3339形式、例: 2023-01-01T00:00:00Z） | いいえ | - |
| end_time | ログの終了時間（RFC3339形式、例: 2023-01-01T00:00:00Z） | いいえ | - |
| log_level | ログレベル（INFO, ERROR, WARNINGなど） | いいえ | - |
| keywords | 検索キーワードの配列 | いいえ | - |
| limit | 取得するログエントリの最大数 | いいえ | 100 |
使用例：
{
"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 | Google Cloudプロジェクトのプロジェクトid | はい | - |
| region | Cloud Runのリージョン | いいえ | us-central1 |
使用例：
{
"project_id": "your-project-id",
"region": "us-central1"
}
AIアシスタントとの連携
AIアシスタントとMCPサーバーを連携するには、以下の手順を実行します：
- MCPサーバーを起動します
- AIアシスタントにMCPサーバーのURLを提供します（例：
http://localhost:3000） - 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コマンドのオプション
| オプション | 短縮形 | 説明 | 必須 | デフォルト値 |
|---|---|---|---|---|
| --project | -p | Google Cloudプロジェクトのプロジェクトid | はい | - |
| --service | -s | Cloud Runのサービス名 | いいえ | - |
| --start-time | -st | ログの開始時間（RFC3339形式） | いいえ | - |
| --end-time | -et | ログの終了時間（RFC3339形式） | いいえ | - |
| --level | -l | ログレベル（INFO, ERROR, WARNINGなど） | いいえ | - |
| --keyword | -k | 検索キーワード（複数指定可） | いいえ | - |
| --limit | -n | 取得するログエントリの最大数 | いいえ | 100 |
| --json | -j | ログをJSON形式で出力 | いいえ | false |
servicesコマンドのオプション
| オプション | 短縮形 | 説明 | 必須 | デフォルト値 |
|---|---|---|---|---|
| --project | -p | Google Cloudプロジェクトのプロジェクトid | はい | - |
| --region | -r | Cloud Runのリージョン | いいえ | us-central1 |
| --json | -j | サービス一覧をJSON形式で出力 | いいえ | false |
ライブラリとしての使用
このツールは、ライブラリとしても使用できます。以下は使用例です：
ログの取得
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
