This is not a Ready MCP Server

GCP MCP Server

A comprehensive Model Context Protocol (MCP) server implementation for Google Cloud Platform (GCP) services, enabling AI assistants to interact with and manage GCP resources through a standardized interface.

Overview

GCP MCP Server provides AI assistants with capabilities to:

• Query GCP Resources: Get information about your cloud infrastructure

• Manage Cloud Resources: Create, configure, and manage GCP services

• Receive Assistance: Get AI-guided help with GCP configurations and best practices

The implementation follows the MCP specification to enable AI systems to interact with GCP services in a secure, controlled manner.

Related MCP server: Google Classroom MCP Server

Supported GCP Services

This implementation includes support for the following GCP services:

• Artifact Registry: Container and package management

• BigQuery: Data warehousing and analytics

• Cloud Audit Logs: Logging and audit trail analysis

• Cloud Build: CI/CD pipeline management

• Cloud Compute Engine: Virtual machine instances

• Cloud Monitoring: Metrics, alerting, and dashboards

• Cloud Run: Serverless container deployments

• Cloud Storage: Object storage management

Architecture

The project is structured as follows:

Key components:

• Service Modules: Each GCP service has its own module with resources, tools, and prompts

• Client Instances: Centralized client management for authentication and resource access

• Core Components: Base functionality for the MCP server implementation

Getting Started

Prerequisites

• Python 3.10+

• GCP project with enabled APIs for the services you want to use

• Authenticated GCP credentials (Application Default Credentials recommended)

Installation

1. Clone the repository:

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

2. Set up a virtual environment:

   python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt

4. Configure your GCP credentials:

   # Using gcloud gcloud auth application-default login # Or set GOOGLE_APPLICATION_CREDENTIALS export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account-key.json"

5. Set up environment variables:

   cp .env.example .env # Edit .env with your configuration

Running the Server

Start the MCP server:

For development and testing:

Docker Deployment

Build and run with Docker:

Configuration

The server can be configured through environment variables or a configuration file:

See .env.example for a complete list of configuration options.

Development

Adding a New GCP Service

1. Create a new file in the services/ directory

2. Implement the service following the pattern in existing services

3. Register the service in main.py

See the services README for detailed implementation guidance.

Security Considerations

• The server uses Application Default Credentials for authentication

• Authorization is determined by the permissions of the authenticated identity

• No credentials are hardcoded in the service implementations

• Consider running with a service account with appropriate permissions

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository

2. Create your feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add some amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

License

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

Acknowledgments

• Google Cloud Platform team for their comprehensive APIs

• Model Context Protocol for providing a standardized way for AI to interact with services

Using the Server

To use this server:

1. Place your GCP service account key file as service-account.json in the same directory

2. Install the MCP package: pip install "mcp[cli]"

3. Install the required GCP package: pip install google-cloud-run

4. Run: mcp dev gcp_cloudrun_server.py

Or install it in Claude Desktop:

MCP Server Configuration

The following configuration can be added to your configuration file for GCP Cloud Tools:

Configuration Details

This configuration sets up an MCP server for Google Cloud Platform tools with the following:

• Command: Uses uv package manager to run the server

• Dependencies: Includes various Google Cloud libraries (Artifact Registry, BigQuery, Cloud Build, etc.)

• Environment Variables:

  • GOOGLE_APPLICATION_CREDENTIALS: Path to your GCP service account credentials

  • GCP_PROJECT_ID: Your Google Cloud project ID

  • GCP_LOCATION: GCP region (us-east1)

Usage

Add this configuration to your MCP configuration file to enable GCP Cloud Tools functionality.