Files
cp1-agents/mcp-servers/gcp-discovery.server.yaml
Jonathan Boniface c14a94f33b
Some checks failed
check agents / check (push) Failing after 12s
Add hyperscaler discovery MCP servers and Well-Architected guidance
azure-discovery, aws-discovery and gcp-discovery collect read-only metadata
on servers, workloads, Kubernetes clusters, networks, data stores, policies
and provider recommendations. Credentials arrive per call from the vault.
Replies are paged, scrubbed of secrets and anonymised, and throttled calls
back off. cloud-knowledge searches each provider's Well-Architected guidance
from fixed lists only, so no customer detail can leave the platform.

Adds shared skills, the render and test tooling, a public Python Dockerfile
until the hardened base image is reachable, the customer access guide, the
implementation plan and the Vault Service platform issue.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-30 20:11:57 +00:00

256 lines
11 KiB
YAML

# Read-only discovery of a customer's Google Cloud estate. Render with scripts/render_mcp_server.py.
# Credentials arrive per call from the Vault Service. Store them per project, never tenant-wide.
server_id: gcp-discovery
name: Google Cloud Discovery
description: Read-only discovery of a customer's Google Cloud estate - servers, workloads, Kubernetes clusters,
networks, data stores, policies and Recommender findings - through Cloud Asset Inventory.
version: 0.1.1
port: 8113
verify_tool: gcp_check_connection
shared_code:
- _common/tool_support.py
- _common/gcp_support.py
extra_requirements:
- google-auth==2.62.0
- requests==2.32.5
connection_fields:
- name: scope_root
title: Scope root
description: 'What may be read: organizations/<id>, folders/<id> or projects/<id>.'
required: true
secret: false
- name: service_account_json
title: Service account key
description: The read-only service account's JSON key.
required: true
secret: true
tools:
- name: gcp_check_connection
display_name: Check connection
description: 'Test the stored connection: sign in and search the scope root. Returns no customer data.'
parameters: []
ai_implementation: |
async def gcp_check_connection(arguments: Dict[str, Any]) -> Dict[str, Any]:
try:
await _gcp_get(f"{GCP_ASSET_API}/{_gcp_scope()}:searchAllResources", {"pageSize": 1})
except Exception as error:
return {"ok": False, "message": _upstream_failed("gcp", error)["error"]["message"]}
return {"ok": True, "message": "Signed in and searched the scope root."}
- name: gcp_list_accounts
display_name: List accounts
description: 'List the estate structure: projects or folders under the scope root.'
parameters:
- name: kind
type: string
description: 'One of: projects, folders.'
required: false
- &id001
name: page_size
type: integer
description: Items per page, up to 200. Default 50.
required: false
- &id002
name: page_token
type: string
description: next_page_token from the previous reply.
required: false
ai_implementation: |
async def gcp_list_accounts(arguments: Dict[str, Any]) -> Dict[str, Any]:
return await _gcp_kind("gcp_list_accounts", arguments, GCP_ACCOUNTS, "projects")
- name: gcp_list_resources
display_name: List resources
description: List every resource under the scope root, or one asset type.
parameters:
- name: asset_type
type: string
description: Optional asset type, such as compute.googleapis.com/Instance.
required: false
- *id001
- *id002
ai_implementation: |
async def gcp_list_resources(arguments: Dict[str, Any]) -> Dict[str, Any]:
asset_type = arguments.get("asset_type")
if asset_type and not re.fullmatch(r"[a-z0-9.]+\.googleapis\.com/[A-Za-z0-9]+", str(asset_type)):
return _refuse("invalid_argument", "asset_type must look like compute.googleapis.com/Instance")
return await _gcp_search("gcp_list_resources", arguments, [asset_type] if asset_type else [])
- name: gcp_query_resources
display_name: Query resources
description: Search resources under the scope root with Cloud Asset's query syntax.
parameters:
- name: query
type: string
description: A Cloud Asset search query, such as location:europe-west2.
required: true
- name: asset_type
type: string
description: Optional asset type.
required: false
- *id001
- *id002
ai_implementation: |
async def gcp_query_resources(arguments: Dict[str, Any]) -> Dict[str, Any]:
query = str(arguments.get("query") or "").strip()
if not query or len(query) > 2000:
return _refuse("invalid_argument", "query is required, up to 2000 characters")
asset_type = arguments.get("asset_type")
return await _gcp_search("gcp_query_resources", arguments, [asset_type] if asset_type else [], query)
- name: gcp_get_resource_metadata
display_name: Get resource metadata
description: Read-only provider metadata for one resource under the scope root.
parameters:
- name: resource_name
type: string
description: The full resource name, starting //.
required: true
- name: scope_entry_id
type: string
description: The scope entry this answers, echoed in the reply.
required: false
ai_implementation: |
async def gcp_get_resource_metadata(arguments: Dict[str, Any]) -> Dict[str, Any]:
name = str(arguments.get("resource_name") or "")
if not re.fullmatch(r"//[a-z0-9.]+\.googleapis\.com/[A-Za-z0-9._/\-]+", name):
return _refuse("invalid_argument", "resource_name must be a full resource name")
try:
body = await _gcp_get(f"{GCP_ASSET_API}/{_gcp_scope()}:searchAllResources", {"query": f'name="{name}"', "readMask": "*", "pageSize": 5})
except Exception as error:
return _upstream_failed("gcp", error)
found = [r for r in body.get("results", []) if r.get("name") == name]
if not found:
return _refuse("outside_scope", "no such resource under this connection's scope")
return _one_result("gcp", "gcp_get_resource_metadata", arguments, found[0])
- name: gcp_list_servers
display_name: List servers
description: List Compute Engine instances, instance groups or disks.
parameters:
- name: kind
type: string
description: 'One of: instances, instance_groups, disks.'
required: false
- *id001
- *id002
ai_implementation: |
async def gcp_list_servers(arguments: Dict[str, Any]) -> Dict[str, Any]:
return await _gcp_kind("gcp_list_servers", arguments, GCP_SERVERS, "instances")
- name: gcp_list_workloads
display_name: List workloads
description: List Cloud Run services, Cloud Functions or App Engine services. Environment variables are removed.
parameters:
- name: kind
type: string
description: 'One of: cloud_run, cloud_functions, app_engine.'
required: false
- *id001
- *id002
ai_implementation: |
async def gcp_list_workloads(arguments: Dict[str, Any]) -> Dict[str, Any]:
return await _gcp_kind("gcp_list_workloads", arguments, GCP_WORKLOADS, "cloud_run")
- name: gcp_list_kubernetes_clusters
display_name: List Kubernetes clusters
description: List GKE clusters or node pools with version and networking. Stops at the cloud control plane.
parameters:
- name: kind
type: string
description: 'One of: clusters, node_pools.'
required: false
- *id001
- *id002
ai_implementation: |
async def gcp_list_kubernetes_clusters(arguments: Dict[str, Any]) -> Dict[str, Any]:
return await _gcp_kind("gcp_list_kubernetes_clusters", arguments, GCP_KUBERNETES, "clusters")
- name: gcp_get_network_topology
display_name: Get network topology
description: List VPC networks, subnetworks, routes, firewall rules, load balancers or gateways.
parameters:
- name: kind
type: string
description: 'One of: networks, subnetworks, routes, firewall_rules, load_balancers, gateways.'
required: false
- *id001
- *id002
ai_implementation: |
async def gcp_get_network_topology(arguments: Dict[str, Any]) -> Dict[str, Any]:
return await _gcp_kind("gcp_get_network_topology", arguments, GCP_NETWORK, "networks")
- name: gcp_list_data_stores
display_name: List data stores
description: List Cloud SQL instances, Firestore databases or Cloud Storage buckets. Metadata only.
parameters:
- name: kind
type: string
description: 'One of: cloud_sql, firestore, cloud_storage.'
required: false
- *id001
- *id002
ai_implementation: |
async def gcp_list_data_stores(arguments: Dict[str, Any]) -> Dict[str, Any]:
return await _gcp_kind("gcp_list_data_stores", arguments, GCP_DATA, "cloud_sql")
- name: gcp_list_organization_policies
display_name: List organization policies
description: List Organization Policy constraints set at the scope root, or VPC Service Controls perimeters.
parameters:
- name: kind
type: string
description: 'One of: organization_policies, vpc_service_controls.'
required: false
- *id001
- *id002
ai_implementation: |
async def gcp_list_organization_policies(arguments: Dict[str, Any]) -> Dict[str, Any]:
kind = arguments.get("kind") or "organization_policies"
if kind == "vpc_service_controls":
return await _gcp_kind("gcp_list_organization_policies", arguments, GCP_PERIMETERS, kind)
if kind != "organization_policies":
return _refuse("unknown_kind", "kind must be organization_policies or vpc_service_controls")
return await _gcp_page("gcp_list_organization_policies", arguments, f"{GCP_ORG_POLICY_API}/{_gcp_scope()}/policies", {}, "policies")
- name: gcp_list_resource_policies
display_name: List resource policies
description: List IAM policies set on resources under the scope root. People and groups are anonymised; service
accounts stay.
parameters:
- name: query
type: string
description: Optional Cloud Asset IAM search query.
required: false
- *id001
- *id002
ai_implementation: |
async def gcp_list_resource_policies(arguments: Dict[str, Any]) -> Dict[str, Any]:
params = {"query": arguments["query"]} if arguments.get("query") else {}
return await _gcp_page("gcp_list_resource_policies", arguments, f"{GCP_ASSET_API}/{_gcp_scope()}:searchAllIamPolicies", params, "results")
- name: gcp_list_recommendations
display_name: List recommendations
description: List Recommender findings for one project, each with a common Well-Architected pillar.
parameters:
- name: project_id
type: string
description: A project under the scope root.
required: true
- name: recommender
type: string
description: 'One of the supported recommender ids. Default: machine type.'
required: false
- name: location
type: string
description: A zone or region. Default global.
required: false
- *id001
- *id002
ai_implementation: |
async def gcp_list_recommendations(arguments: Dict[str, Any]) -> Dict[str, Any]:
project_id = str(arguments.get("project_id") or "")
location = str(arguments.get("location") or "global")
recommender = arguments.get("recommender") or GCP_RECOMMENDERS[0]
if recommender not in GCP_RECOMMENDERS:
return _refuse("unknown_kind", "recommender must be one of: " + ", ".join(GCP_RECOMMENDERS))
if not re.fullmatch(r"[a-z0-9\-]+", project_id) or not re.fullmatch(r"[a-z0-9\-]+", location):
return _refuse("invalid_argument", "project_id and location must be plain identifiers")
try:
allowed = await _gcp_project_in_scope(project_id)
except Exception as error:
return _upstream_failed("gcp", error)
if not allowed:
return _refuse("outside_scope", "project_id isn't under this connection's scope")
url = f"{GCP_RECOMMENDER_API}/projects/{project_id}/locations/{location}/recommenders/{recommender}/recommendations"
return await _gcp_page("gcp_list_recommendations", arguments, url, {}, "recommendations", _gcp_recommendation)