- 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>
264 lines
12 KiB
YAML
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)
|