GCP MCP

GCP MCP

Claude などの AI アシスタントが Google Cloud Platform 環境とやり取りできるようにする Model Context Protocol（MCP）サーバーです。これにより、会話中に自然言語で GCP リソースを照会、管理できます。

特徴

• 🔍 自然言語を使って GCP リソースを照会、変更できます
• ☁️ 複数の GCP プロジェクトに対応しています
• 🌐 複数のリージョンに対応しています
• 🔐 認証情報を安全に扱います（認証情報が外部サービスに公開されることはありません）
• 🏃‍♂️ GCP 認証情報を使ってローカルで実行します
• 🔄 信頼性を高めるため、自動的に再試行します

前提条件

• Node.js
• Claude Desktop/Cursor/Windsurf
• GCP 認証情報がローカルで設定されていること（アプリケーションのデフォルト認証情報）

インストール

1. リポジトリをクローンします：

git clone https://github.com/eniayomi/gcp-mcp
cd gcp-mcp

2. 依存関係をインストールします：

npm install

設定

Claude Desktop

1. Claude デスクトップアプリを開き、「Settings」->「Developer」->「Edit Config」に移動します

2. claude_desktop_config.json に次のエントリを追加します：

npm 経由の場合：

{
  "mcpServers": {
    "gcp": {
      "command": "sh",
      "args": ["-c", "npx -y gcp-mcp"]
    }
  }
}

ソースからインストールした場合：

{
  "mcpServers": {
    "gcp": {
      "command": "npm",
      "args": [
        "--silent",
        "--prefix",
        "/path/to/gcp-mcp",
        "start"
      ]
    }
  }
}

ソースからインストールする場合は、/path/to/gcp-mcp をプロジェクトディレクトリの実際のパスに置き換えてください。

Cursor

1. Cursor を開き、「Settings」（⌘,）に移動します
2. 「AI」->「Model Context Protocol」に移動します
3. 新しい MCP 設定を追加します：

{
  "gcp": {
    "command": "npx -y gcp-mcp"
  }
}

Windsurf

1. ~/.windsurf/config.json を開きます（存在しない場合は作成します）
2. MCP 設定を追加します：

{
  "mcpServers": {
    "gcp": {
      "command": "npx -y gcp-mcp"
    }
  }
}

GCP の設定

1. GCP 認証情報を設定します：

   • gcloud auth application-default login を使用して、アプリケーションのデフォルト認証情報を設定します

2. AI アシスタント（Claude Desktop/Cursor/Windsurf）を再起動します

使い方

まずプロジェクトを選択するか、次のような質問をします：

• 「アクセス可能な GCP プロジェクトをすべて一覧表示して」
• 「プロジェクト X の Cloud SQL インスタンスをすべて表示して」
• 「現在の請求状況は？」
• 「Cloud Run サービスのログを表示して」
• 「us-central1 の GKE クラスターをすべて一覧表示して」
• 「プロジェクト X の Cloud Storage バケットをすべて表示して」
• 「us-central1 にデプロイされている Cloud Functions は？」
• 「Cloud Run サービスをすべて一覧表示して」
• 「BigQuery のデータセットとテーブルを表示して」

利用可能なツール

1. run-gcp-code：TypeScript コードを使って GCP API 呼び出しを実行します
2. list-projects：アクセス可能な GCP プロジェクトをすべて一覧表示します
3. select-project：以降の操作で使用する GCP プロジェクトを選択します
4. get-billing-info：現在のプロジェクトの請求情報を取得します
5. get-cost-forecast：現在のプロジェクトのコスト予測を取得します
6. get-billing-budget：現在のプロジェクトの請求予算を取得します
7. list-gke-clusters：現在のプロジェクトの GKE クラスターをすべて一覧表示します
8. list-sql-instances：現在のプロジェクトの Cloud SQL インスタンスをすべて一覧表示します
9. get-logs：現在のプロジェクトの Cloud Logging エントリを取得します

操作例

1. 利用可能なプロジェクトを一覧表示します：

List all GCP projects I have access to

2. プロジェクトを選択します：

Use project my-project-id

3. 請求状況を確認します：

What's my current billing status?

4. ログを表示します：

Show me the last 10 log entries from my project

対応サービス

• Google Compute Engine
• Cloud Storage
• Cloud Functions
• Cloud Run
• BigQuery
• Cloud SQL
• Google Kubernetes Engine（GKE）
• Cloud Logging
• Cloud Billing
• Resource Manager
• 今後さらに追加予定です...

トラブルシューティング

ログを表示するには：

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-gcp.log

よくある問題：

1. 認証エラー：gcloud auth application-default login を実行したことを確認してください
2. 権限エラー：アカウントの IAM ロールを確認してください
3. API エラー：プロジェクトで必要な API が有効になっていることを確認してください

コントリビューション

コントリビューションを歓迎します！お気軽に Pull Request を送信してください。

ライセンス

MIT