Files
cp1-agents/mcp-servers/cloud-knowledge.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

80 lines
3.4 KiB
YAML

# 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)}}