Files
cp1-agents/mcp-servers/azure-discovery.server.yaml
Jonathan Boniface f659564208 Platform scripts, MCP servers, deployment and docs for the KAB runs
- Scripts to run workflows from a YAML context or run inputs (kab_run_workflow.py, with
  --input name=@file), store per-project discovery connections, bootstrap agent MCP keys,
  refresh the KAB token, publish reports and build estate snapshots.
- Hyperscaler discovery servers extended in place; cloud-knowledge folded into them.
- deploy/crucible-kab-dev.yaml: the Discovery package agent and the Assessment agents.
- Platform issue write-ups and current-wiring notes under docs/platform-issues/.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 22:13:25 +00:00

264 lines
12 KiB
YAML

# Read-only discovery of a customer's Azure 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: azure-discovery
name: Azure Discovery
description: Read-only discovery of a customer's Azure estate - servers, workloads, Kubernetes clusters, networks,
data stores, policies and Advisor findings - through Azure Resource Graph.
version: 0.1.6
port: 8111
verify_tool: azure_check_connection
shared_code:
- _common/tool_support.py
- _common/azure_support.py
- _common/knowledge_support.py
connection_fields:
- name: tenant_id
title: Tenant ID
description: The customer's Microsoft Entra tenant id.
required: false
secret: false
- name: client_id
title: Client ID
description: The application (client) id of the read-only app registration.
required: false
secret: false
- name: client_secret
title: Client secret
description: The app registration's client secret.
required: false
secret: true
- name: access_token
title: Access token
description: For a short trial only, instead of the three fields above. A token from az account get-access-token. It expires within about an hour and carries that person's own Azure permissions.
required: false
secret: true
- name: scope_root
title: Scope root
description: 'What may be read: managementGroups/<id>, subscriptions/<id>, or one resource group, subscriptions/<id>/resourceGroups/<name>.'
required: true
secret: false
- name: cloud
title: Cloud
description: public, usgov or china. Default public.
required: false
secret: false
tools:
- name: azure_check_connection
display_name: Check connection
description: 'Test the stored connection: sign in and read the scope root. Returns no customer data.'
parameters: []
ai_implementation: |
async def azure_check_connection(arguments: Dict[str, Any]) -> Dict[str, Any]:
try:
group = _azure_root(get_connection())[2]
query = "ResourceContainers | where type =~ 'microsoft.resources/subscriptions/resourcegroups' | summarize count()" if group else "ResourceContainers | summarize count()"
body = await _azure_graph(query, 1)
except Exception as error:
return {"ok": False, "message": _upstream_failed("azure", error)["error"]["message"]}
if group and not any(int(v or 0) for row in body.get("data", []) for v in row.values()):
return {"ok": False, "message": "Signed in, but the resource group in the scope root was not found or is not readable."}
return {"ok": True, "message": "Signed in and read the scope root."}
- name: azure_list_accounts
display_name: List accounts
description: 'List the estate structure: management groups, subscriptions and resource groups.'
parameters:
- name: kind
type: string
description: 'One of: subscriptions, management_groups, resource_groups.'
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 azure_list_accounts(arguments: Dict[str, Any]) -> Dict[str, Any]:
kinds = {"subscriptions": ["microsoft.resources/subscriptions"], "management_groups": ["microsoft.management/managementgroups"], "resource_groups": ["microsoft.resources/subscriptions/resourcegroups"]}
return await _azure_kind("azure_list_accounts", arguments, kinds, "ResourceContainers", "subscriptions")
- name: azure_list_resources
display_name: List resources
description: List every resource in scope, or one resource type, with id, type, location and tags.
parameters:
- name: resource_type
type: string
description: Optional ARM type, such as microsoft.compute/virtualmachines.
required: false
- *id001
- *id002
ai_implementation: |
async def azure_list_resources(arguments: Dict[str, Any]) -> Dict[str, Any]:
kind = arguments.get("resource_type")
if kind and not re.fullmatch(r"[A-Za-z0-9./]+", str(kind)):
return _refuse("invalid_argument", "resource_type must be an ARM type")
where = f" | where type =~ '{kind}'" if kind else ""
return await _azure_page("azure_list_resources", arguments, f"Resources{where} | project id, name, type, location, resourceGroup, subscriptionId, tags | order by id asc")
- name: azure_query_resources
display_name: Query resources
description: Run a read-only Azure Resource Graph KQL query over the connection's scope. Secrets and people are
removed from the results.
parameters:
- name: query
type: string
description: KQL starting with a Resource Graph table.
required: true
- *id001
- *id002
ai_implementation: |
async def azure_query_resources(arguments: Dict[str, Any]) -> Dict[str, Any]:
query = str(arguments.get("query") or "").strip()
if not query or len(query) > 4000:
return _refuse("invalid_argument", "query is required, up to 4000 characters")
if query.split("|")[0].strip().lower() not in AZURE_TABLES:
return _refuse("invalid_argument", "query must start with one of: " + ", ".join(AZURE_TABLES))
return await _azure_page("azure_query_resources", arguments, query)
- name: azure_get_resource_metadata
display_name: Get resource metadata
description: Read-only provider metadata for one resource inside the connection's scope.
parameters:
- name: resource_id
type: string
description: The full ARM resource id.
required: true
- name: scope_entry_id
type: string
description: The scope entry this answers, echoed in the reply.
required: false
ai_implementation: |
async def azure_get_resource_metadata(arguments: Dict[str, Any]) -> Dict[str, Any]:
resource_id = str(arguments.get("resource_id") or "")
if not re.fullmatch(r"/subscriptions/[A-Za-z0-9\-]+(/[A-Za-z0-9._()\-]+)+", resource_id):
return _refuse("invalid_argument", "resource_id must be a full ARM resource id")
try:
body = await _azure_graph(f"Resources | where id =~ '{resource_id}'", 1)
except Exception as error:
return _upstream_failed("azure", error)
if not body.get("data"):
return _refuse("outside_scope", "no such resource inside this connection's scope")
return _one_result("azure", "azure_get_resource_metadata", arguments, body["data"][0])
- name: azure_list_servers
display_name: List servers
description: List virtual machines, scale sets or managed disks.
parameters:
- name: kind
type: string
description: 'One of: virtual_machines, scale_sets, disks.'
required: false
- *id001
- *id002
ai_implementation: |
async def azure_list_servers(arguments: Dict[str, Any]) -> Dict[str, Any]:
return await _azure_kind("azure_list_servers", arguments, AZURE_SERVERS)
- name: azure_list_workloads
display_name: List workloads
description: List App Service, Container Apps or Container Instances workloads.
parameters:
- name: kind
type: string
description: 'One of: app_service, container_apps, container_instances.'
required: false
- *id001
- *id002
ai_implementation: |
async def azure_list_workloads(arguments: Dict[str, Any]) -> Dict[str, Any]:
return await _azure_kind("azure_list_workloads", arguments, AZURE_WORKLOADS)
- name: azure_list_kubernetes_clusters
display_name: List Kubernetes clusters
description: List AKS clusters with version, node pools and networking. Stops at the cloud control plane.
parameters: &id003
- *id001
- *id002
ai_implementation: |
async def azure_list_kubernetes_clusters(arguments: Dict[str, Any]) -> Dict[str, Any]:
return await _azure_kind("azure_list_kubernetes_clusters", arguments, AZURE_KUBERNETES)
- name: azure_get_network_topology
display_name: Get network topology
description: List virtual networks with their subnets and peerings, or route tables, NSGs, gateways, load balancers,
private endpoints or public IPs.
parameters:
- name: kind
type: string
description: 'One of: virtual_networks, route_tables, network_security_groups, gateways, load_balancers, private_endpoints,
public_ips.'
required: false
- *id001
- *id002
ai_implementation: |
async def azure_get_network_topology(arguments: Dict[str, Any]) -> Dict[str, Any]:
return await _azure_kind("azure_get_network_topology", arguments, AZURE_NETWORK)
- name: azure_list_data_stores
display_name: List data stores
description: List SQL, Cosmos DB, storage account, PostgreSQL, MySQL or Redis metadata. Never rows, documents or blobs.
parameters:
- name: kind
type: string
description: 'One of: sql, cosmos_db, storage_accounts, postgresql, mysql, redis.'
required: false
- *id001
- *id002
ai_implementation: |
async def azure_list_data_stores(arguments: Dict[str, Any]) -> Dict[str, Any]:
return await _azure_kind("azure_list_data_stores", arguments, AZURE_DATA)
- name: azure_list_organization_policies
display_name: List organization policies
description: List Azure Policy assignments, definitions, initiatives, exemptions or compliance states.
parameters:
- name: kind
type: string
description: 'One of: assignments, definitions, initiatives, exemptions, compliance.'
required: false
- *id001
- *id002
ai_implementation: |
async def azure_list_organization_policies(arguments: Dict[str, Any]) -> Dict[str, Any]:
return await _azure_kind("azure_list_organization_policies", arguments, AZURE_ORG_POLICIES, "PolicyResources", "assignments")
- name: azure_list_resource_policies
display_name: List resource policies
description: List Key Vault access policies (never secret values), storage network rules or resource locks. Principals
are anonymised.
parameters:
- name: subscription_id
type: string
description: For resource_locks. Needed when the scope root is a management group.
required: false
- name: kind
type: string
description: 'One of: key_vault_access, storage_network_rules, resource_locks.'
required: false
- *id001
- *id002
ai_implementation: |
async def azure_list_resource_policies(arguments: Dict[str, Any]) -> Dict[str, Any]:
if arguments.get("kind") == "resource_locks":
return await _azure_locks("azure_list_resource_policies", arguments)
return await _azure_kind("azure_list_resource_policies", arguments, AZURE_RESOURCE_POLICIES)
- name: azure_list_recommendations
display_name: List recommendations
description: List Azure Advisor recommendations, each with a common Well-Architected pillar.
parameters: *id003
ai_implementation: |
async def azure_list_recommendations(arguments: Dict[str, Any]) -> Dict[str, Any]:
query = "AdvisorResources | where type =~ 'microsoft.advisor/recommendations' | order by id asc"
return await _azure_page("azure_list_recommendations", arguments, query, _azure_recommendation)
- name: azure_search_well_architected
display_name: Search Well-Architected guidance
description: Search the Azure Well-Architected Framework's guidance by pillar and topic. Both come from fixed lists, so no customer detail
leaves the platform. Microsoft Learn is public, so no credential is used.
parameters:
- name: pillar
type: string
description: reliability, security, cost, operations, performance or sustainability.
required: true
- name: topic
type: string
description: One of the fixed topics; an invalid value lists them.
required: true
ai_implementation: |
async def azure_search_well_architected(arguments: Dict[str, Any]) -> Dict[str, Any]:
return await _knowledge_tool("azure", "azure_search_well_architected", arguments, {}, None)