Add hyperscaler discovery MCP servers and Well-Architected guidance
Some checks failed
check agents / check (push) Failing after 12s

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>
This commit is contained in:
2026-10-30 20:11:57 +00:00
parent 416c66ced4
commit c14a94f33b
91 changed files with 13296 additions and 1 deletions

View File

@@ -0,0 +1,79 @@
# Hyperscaler Well-Architected guidance, for later workflows such as ALZ-F05 Target Architecture.
# Holds Kyndryl's access, never a customer's. Store its connection tenant-wide. Queries come from fixed lists only.
server_id: cloud-knowledge
name: Cloud Knowledge
description: Well-Architected guidance from each hyperscaler's own knowledge server, searched by fixed pillar and
topic.
version: 0.1.1
port: 8114
verify_tool: cloud_check_connection
shared_code:
- _common/tool_support.py
- _common/knowledge_support.py
extra_requirements:
- boto3==1.43.122
connection_fields:
- name: aws_access_key_id
title: AWS access key ID
description: Kyndryl's identity for the AWS MCP Server.
required: false
secret: false
- name: aws_secret_access_key
title: AWS secret access key
description: Its secret key.
required: false
secret: true
- name: google_api_key
title: Google API key
description: Kyndryl's key for the Developer Knowledge API.
required: false
secret: true
tools:
- name: cloud_check_connection
display_name: Check connection
description: Test that the knowledge servers answer. Sends no customer data.
parameters: []
ai_implementation: |
async def cloud_check_connection(arguments: Dict[str, Any]) -> Dict[str, Any]:
results = {}
connection = get_connection()
for provider in KNOWLEDGE_SERVERS:
try:
await _knowledge_tools(provider, connection)
results[provider] = "reachable"
except Exception as error:
results[provider] = type(error).__name__
return {"ok": all(v == "reachable" for v in results.values()), "message": json.dumps(results)}
- name: cloud_search_well_architected
display_name: Search Well-Architected guidance
description: Search a hyperscaler's Well-Architected guidance by pillar and topic. Both come from fixed lists,
so no customer detail can leave the platform.
parameters:
- name: provider
type: string
description: azure, aws or gcp.
required: true
- 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 cloud_search_well_architected(arguments: Dict[str, Any]) -> Dict[str, Any]:
provider, pillar, topic = arguments.get("provider"), arguments.get("pillar"), arguments.get("topic")
if provider not in KNOWLEDGE_SERVERS:
return _refuse("invalid_argument", "provider must be azure, aws or gcp")
if pillar not in KNOWLEDGE_PILLARS:
return _refuse("invalid_argument", "pillar must be one of: " + ", ".join(KNOWLEDGE_PILLARS))
if topic not in KNOWLEDGE_TOPICS:
return _refuse("invalid_argument", "topic must be one of: " + ", ".join(KNOWLEDGE_TOPICS))
query = f"{KNOWLEDGE_SERVERS[provider]['framework']} {pillar} {topic}"
try:
results = await _knowledge_search(provider, get_connection(), query)
except Exception as error:
return _upstream_failed(provider, error)
return {"success": True, "data": {"provider": provider, "pillar": pillar, "topic": topic, "results": results, "collected_at": _collected_at(), "evidence_ref": _evidence_ref("cloud_search_well_architected", arguments, results)}}