Servidor MCP Gcp Telemetry | PlugMCP
Pular para o conteúdo Do publicador
Documentação GCP Telemetry MCP Server
A Model Context Protocol (MCP) server for Google Cloud Platform telemetry services, providing seamless integration with GCP observability tools.
Features
Cloud Logging
✅ Write log entries with structured data
✅ Support for multiple severity levels (DEBUG, INFO, WARNING, ERROR, CRITICAL)
WIP: Google Cloud telemetry MCP server
Conecte qualquer ferramenta a qualquer agente. Diretório MCP para quem não escreve servidores.
Produto
Diretório
Desenvolvedores
Empresa
Estrelas 7
Ferramentas —
Disponibilidade —
✅ Custom labels and structured payloads
✅ List log entries with filtering and pagination
Cloud Monitoring
✅ Create custom metric descriptors
✅ Write time series data points
✅ Query time series data with advanced filtering
✅ Support for all metric kinds (GAUGE, DELTA, CUMULATIVE)
✅ Support for all value types (BOOL, INT64, DOUBLE, STRING, DISTRIBUTION)
✅ Advanced aggregation options (alignment periods, reducers)
✅ Delete custom metric descriptors
✅ List available metric descriptors
✅ Discover available Google Cloud service metrics
Cloud Trace
✅ List traces with advanced filtering and pagination
✅ Get specific traces by trace ID
✅ Update/patch trace spans with new data
✅ Support for distributed trace analysis
Cloud Profiler
✅ Create new profiling sessions for applications
✅ Create offline profiles with existing profiling data
✅ Update profile metadata and data
✅ List profiles with pagination
✅ Support for multiple profile types (CPU, HEAP, THREADS, CONTENTION, WALL)
Prerequisites
Go 1.24.2 or later
Google Cloud Project with appropriate APIs enabled
Authentication credentials configured (see Authentication )
Installation
From Source git clone https://github.com/kitagry/gcp-telemetry-mcp.git
cd gcp-telemetry-mcp
go build -o gcp-telemetry-mcp
Authentication This server uses Google Cloud authentication. Configure one of the following:
Service Account Key File :
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account-key.json"
Application Default Credentials (if running on GCP):
gcloud auth application-default login
Workload Identity (for GKE/Cloud Run deployments)
Configuration Set the required environment variable:
export GOOGLE_CLOUD_PROJECT="your-project-id"
Usage
Running the Server
MCP Tools The server provides the following MCP tools:
Cloud Logging Tools
write_log_entryWrite a log entry to Cloud Logging.
log_name (string, required): Name of the log to write to
severity (string, required): Log severity (DEBUG, INFO, WARNING, ERROR, CRITICAL)
message (string, required): Log message
labels (object, optional): Key-value pairs for log labels
payload (object, optional): Structured data payload
{
"log_name": "my-application-log",
"severity": "INFO",
"message": "User login successful",
"labels": {
"user_id": "12345",
"environment": "production"
},
"payload": {
"event": "user_login",
"timestamp": "2024-01-01T12:00:00Z",
"ip_address": "192.168.1.1"
}
}
list_log_entriesList log entries from Cloud Logging.
filter (string, optional): Cloud Logging filter expression
limit (number, optional): Maximum number of entries to return (default: 50)
{
"filter": "severity>=ERROR",
"limit": 100
}
Cloud Monitoring Tools
create_metric_descriptorCreate a custom metric descriptor in Cloud Monitoring.
type (string, required): Metric type (e.g., 'custom.googleapis.com/my_metric')
metric_kind (string, required): Metric kind (GAUGE, DELTA, or CUMULATIVE)
value_type (string, required): Value type (BOOL, INT64, DOUBLE, STRING, or DISTRIBUTION)
description (string, required): Description of the metric
display_name (string, optional): Display name for the metric
{
"type": "custom.googleapis.com/app/response_time",
"metric_kind": "GAUGE",
"value_type": "DOUBLE",
"description": "Application response time in seconds",
"display_name": "App Response Time"
}
write_time_seriesWrite time series data to Cloud Monitoring.
metric_type (string, required): Metric type to write data for
resource_type (string, required): Resource type (e.g., 'global', 'gce_instance')
value (number, required): Metric value to write
metric_labels (object, optional): Optional metric labels
timestamp (string, optional): Timestamp for the data point (ISO 8601 format, defaults to now)
{
"metric_type": "custom.googleapis.com/app/response_time",
"resource_type": "global",
"value": 0.125,
"metric_labels": {
"service": "api",
"version": "v1.2.0"
},
"timestamp": "2024-01-01T12:00:00Z"
}
list_time_seriesList time series data from Cloud Monitoring.
filter (string, required): Monitoring filter expression
start_time (string, required): Start time for the query (ISO 8601 format)
end_time (string, required): End time for the query (ISO 8601 format)
aggregation (object, optional): Aggregation configuration
{
"filter": "metric.type=\"compute.googleapis.com/instance/cpu/usage\"",
"start_time": "2024-01-01T10:00:00Z",
"end_time": "2024-01-01T12:00:00Z",
"aggregation": {
"alignment_period": "60s",
"per_series_aligner": "ALIGN_MEAN",
"cross_series_reducer": "REDUCE_MEAN",
"group_by_fields": ["resource.zone"]
}
}
list_metric_descriptorsList metric descriptors from Cloud Monitoring.
filter (string, optional): Filter expression for metric descriptors
{
"filter": "metric.type=starts_with(\"custom.googleapis.com/\")"
}
delete_metric_descriptorDelete a custom metric descriptor from Cloud Monitoring.
metric_type (string, required): Metric type to delete
{
"metric_type": "custom.googleapis.com/my_old_metric"
}
list_available_metricsList available metrics in Cloud Monitoring including Google Cloud service metrics.
filter (string, optional): Filter expression for metrics (e.g., 'metric.type=starts_with("compute.googleapis.com/")')
page_size (number, optional): Maximum number of metrics to return (default: 100)
page_token (string, optional): Page token for pagination
{
"filter": "metric.type=starts_with(\"compute.googleapis.com/\")",
"page_size": 50
}
Cloud Trace Tools
list_tracesList traces from Cloud Trace.
start_time (string, required): Start time for the query (ISO 8601 format)
end_time (string, required): End time for the query (ISO 8601 format)
filter (string, optional): Filter expression (e.g., 'span_name_prefix:"api"')
order_by (string, optional): Order by field (e.g., 'start_time desc')
page_size (number, optional): Maximum number of traces to return (default: 100)
page_token (string, optional): Page token for pagination
{
"start_time": "2024-01-01T10:00:00Z",
"end_time": "2024-01-01T12:00:00Z",
"filter": "span_name_prefix:\"api\"",
"order_by": "start_time desc",
"page_size": 50
}
get_traceGet a specific trace from Cloud Trace.
trace_id (string, required): Trace ID to retrieve
{
"trace_id": "1234567890abcdef1234567890abcdef"
}
patch_tracesUpdate trace spans in Cloud Trace.
trace_id (string, required): Trace ID to update
spans (array, required): Array of span objects to update or create
{
"trace_id": "1234567890abcdef1234567890abcdef",
"spans": [
{
"span_id": "span123",
"name": "updated-operation",
"start_time": "2024-01-01T12:00:00Z",
"end_time": "2024-01-01T12:00:05Z",
"parent_id": "parent123",
"kind": "RPC_CLIENT",
"labels": {
"service": "api",
"version": "v2.0"
}
}
]
}
Cloud Profiler Tools
create_profileCreate a new profile in Cloud Profiler.
target (string, required): Target deployment name
profile_type (string, required): Profile type (CPU, HEAP, THREADS, CONTENTION, or WALL)
duration (string, optional): Profile duration (e.g., '60s', '5m', defaults to '60s')
labels (object, optional): Optional labels for the profile
{
"target": "my-app-v1",
"profile_type": "CPU",
"duration": "60s",
"labels": {
"service": "web-server",
"version": "v1.2.0"
}
}
create_offline_profileCreate an offline profile in Cloud Profiler with existing profiling data.
target (string, required): Target deployment name
profile_type (string, required): Profile type (CPU, HEAP, THREADS, CONTENTION, or WALL)
profile_data (string, required): Base64-encoded profile data
duration (string, optional): Profile duration (e.g., '60s', '5m')
labels (object, optional): Optional labels for the profile
{
"target": "my-app-v1",
"profile_type": "HEAP",
"profile_data": "base64encodedprofiledata==",
"duration": "30s",
"labels": {
"service": "api-server",
"environment": "production"
}
}
update_profileUpdate a profile in Cloud Profiler.
profile_name (string, required): Profile name to update
profile_data (string, optional): Updated base64-encoded profile data
labels (object, optional): Updated labels for the profile
update_mask (string, optional): Fields to update (e.g., 'labels,profile_bytes')
{
"profile_name": "projects/my-project/profiles/12345",
"profile_data": "newbase64encodeddata==",
"labels": {
"service": "updated-service",
"version": "v1.3.0"
},
"update_mask": "labels,profile_bytes"
}
list_profilesList profiles from Cloud Profiler.
page_size (number, optional): Maximum number of profiles to return (default: 100)
page_token (string, optional): Page token for pagination
{
"page_size": 50,
"page_token": "next_page_token_here"
}
Development
Running Tests
Project Structure .
├── main.go # MCP server implementation and tool handlers
├── logging/
│ ├── client.go # Cloud Logging client implementation
│ └── client_test.go # Tests for logging client
├── monitoring/
│ ├── client.go # Cloud Monitoring client implementation
│ └── client_test.go # Tests for monitoring client
├── trace/
│ ├── client.go # Cloud Trace client implementation
│ └── client_test.go # Tests for trace client
├── profiler/
│ ├── client.go # Cloud Profiler client implementation
│ └── client_test.go # Tests for profiler client
├── go.mod # Go module definition
├── go.sum # Go dependency checksums
└── README.md # This file
Error Handling The server provides detailed error messages for common issues:
Missing GOOGLE_CLOUD_PROJECT environment variable
Authentication failures
Invalid parameters for logging and monitoring operations
Cloud Logging API errors
Cloud Monitoring API errors
Time series data validation errors
Metric descriptor creation/deletion failures
Cloud Trace API errors
Trace retrieval and span update failures
Cloud Profiler API errors
Profile creation and update failures
Contributing
Fork the repository
Create a feature branch
Make your changes
Add tests for new functionality
Submit a pull request
License This project is licensed under the MIT License - see the LICENSE file for details.
Support For issues and questions:
Create an issue in the GitHub repository
Check Google Cloud Logging documentation for logging-specific questions
Check Google Cloud Monitoring documentation for monitoring-specific questions
Check Google Cloud Trace documentation for trace-specific questions
Check Google Cloud Profiler documentation for profiler-specific questions
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas Como instalo Gcp Telemetry? Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Gcp Telemetry precisa de uma chave de API? Este registro não lista nenhuma variável de ambiente obrigatória.
Qual transporte Gcp Telemetry usa? Gcp Telemetry roda localmente via stdio.
Quando Gcp Telemetry foi verificado pela última vez? Última verificação: 2026-10-28. WIP: Google Cloud telemetry MCP server
azure-compute Azure VM/VMSS router. WHEN: create / provision / deploy / spin-up VM, recommend VM size, compare VM pricing, VMSS, scale set, autoscale, burstable, lightweight server, website, backend, GPU, machine l As ferramentas têm descrição 0 de 6