GCP MCP Server

A Model Context Protocol (MCP) server for Google Cloud Platform (GCP) that enables AI assistants to interact with GCP services, particularly focused on log analysis and root cause investigation.

Features

• Cloud Logging Integration: Query and analyze GCP Cloud Logging data

• Real-time Log Streaming: Stream logs for immediate analysis

• Error Pattern Detection: Identify common error patterns and anomalies

• Multi-Project Support: Work across multiple GCP projects

• Secure Authentication: Uses GCP service account credentials

• Root Cause Analysis: Tools to help with quick RC findings

Related MCP server: CloudWatch Logs MCP Server

Supported GCP Services

• Cloud Logging: Query, filter, and analyze logs

• Cloud Monitoring: Retrieve metrics and alerts (planned)

• Error Reporting: Access error statistics and details (planned)

• Cloud Trace: Distributed tracing analysis (planned)

Installation

⚡ Quick Install

Claude Code Integration (One Command!)

The easiest way to add this MCP server to Claude Code:

Or with a service account key file:

Manual Configuration (Alternative)

Add this to your Claude Code configuration:

Prerequisites

• Python 3.8 or higher

• GCP project with appropriate APIs enabled

• Service account with necessary permissions

Manual Setup

1. Clone the repository:

2. Install dependencies:

3. Run with your credentials:

Usage

Starting the Server

Available Tools

Log Query

Query GCP Cloud Logging with advanced filters:

Log Analysis

Analyze logs for patterns and anomalies:

Error Investigation

Find and analyze error patterns:

Configuration

Create a config.json file:

Authentication

The server supports multiple authentication methods:

1. Service Account Key File: Set GOOGLE_APPLICATION_CREDENTIALS

2. Application Default Credentials: For GCE, Cloud Shell, etc.

3. User Credentials: Via gcloud auth application-default login

Required GCP Permissions

Your service account needs the following IAM roles:

• roles/logging.viewer - Read access to Cloud Logging

• roles/monitoring.viewer - Read access to Cloud Monitoring (optional)

• roles/errorreporting.viewer - Read access to Error Reporting (optional)

Development

Running Tests

Code Formatting

Type Checking

Contributing

1. Fork the repository

2. Create a feature branch

3. Make your changes

4. Add tests

5. Run the test suite

6. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Security

• Never commit service account keys to the repository

• Use environment variables for sensitive configuration

• Follow GCP security best practices

• Report security vulnerabilities via email

Support

• Create an issue for bug reports or feature requests

• Check existing issues before creating new ones

• Provide detailed information including logs and configuration

Roadmap

• Cloud Monitoring integration

• Error Reporting tools

• Cloud Trace analysis

• BigQuery log export support

• Alerting and notification tools

• Dashboard generation

• Cost analysis tools