CloudChampion MCP Server

Servidor MCP (Model Context Protocol) para consultar el catálogo de formación de Cloud Champion (cloudchampion.es y variantes por país).

Expone herramientas que permiten a agentes de IA buscar, filtrar y obtener estadísticas sobre webinars, vídeos, learning paths, podcasts y otros recursos de Microsoft para partners.

Arquitectura

Agente IA ──► MCP Server (FastMCP) ──► API Cloud Champion
                  │                     /wp-json/feed/content
                  │
                  └── Caché en memoria (TTL configurable)

Feed API: GET https://www.cloudchampion.es/wp-json/feed/content — catálogo global público (todos los países/idiomas)
Caché: En memoria con TTL de 10 min (configurable) para evitar llamadas excesivas
Búsqueda: Fuzzy matching sin tildes/diacríticos para español y otros idiomas
Transporte: Streamable HTTP (default), SSE o stdio

Herramientas disponibles (Tools)

| Tool | Descripción | |---|---| | buscar_formacion | Búsqueda textual + filtros combinables (país, idioma, tipo, audiencia, área, provider, fechas) | | listar_proximas_formaciones | Formaciones futuras en una ventana de N días | | detalle_formacion | Detalle completo de una formación por título parcial o ID | | listar_filtros_disponibles | Valores únicos disponibles para cada filtro (tipos, áreas, idiomas, etc.) | | estadisticas_catalogo | Estadísticas del catálogo: totales por tipo, área, audiencia, provider, rango de fechas |

Desarrollo local

Requisitos

Python 3.11+
pip

Instalación

# Clonar el repositorio
git clone <repo-url>
cd cloudchampion-mcp

# Instalar dependencias
pip install -r requirements.txt

# (Opcional) Copiar y ajustar variables de entorno
cp .env.example .env

Modo desarrollo con inspector web

fastmcp dev src/mcp_cloudchampion/server.py

Esto abre el inspector web de FastMCP donde puedes probar las tools interactivamente.

Modo stdio (para uso local con clientes MCP)

MCP_TRANSPORT=stdio python -m mcp_cloudchampion.server

Modo HTTP (para acceso remoto)

python -m mcp_cloudchampion.server
# Servidor en http://0.0.0.0:8000

Docker

Build

docker build -t mcp-cloudchampion .

Run

docker run -p 8000:8000 mcp-cloudchampion

Con variables de entorno custom

docker run -p 8000:8000 \
  -e CACHE_TTL_SECONDS=300 \
  -e LOG_LEVEL=DEBUG \
  mcp-cloudchampion

Despliegue en Azure Container Apps

La infraestructura se define como IaC con Bicep en la carpeta infra/.

1. Crear infraestructura con Bicep

RESOURCE_GROUP="rg-cloudchampion-mcp"
LOCATION="westeurope"

# Crear Resource Group
az group create --name $RESOURCE_GROUP --location $LOCATION

# Desplegar infraestructura (ACR + Log Analytics + Container Apps Env + Container App)
az deployment group create \
  --resource-group $RESOURCE_GROUP \
  --template-file infra/main.bicep \
  --parameters infra/main.parameters.json

# Ver outputs (FQDN, MCP endpoint, ACR login server)
az deployment group show \
  --resource-group $RESOURCE_GROUP \
  --name main \
  --query 'properties.outputs' -o json

Recursos creados:

Azure Container Registry (Basic SKU, admin habilitado)
Log Analytics Workspace (retención 30 días)
Container Apps Environment (con logging a Log Analytics)
Container App (scale to zero, 0.25 vCPU, 0.5 GiB RAM, ingress HTTP externo)

2. Build & Deploy de la imagen

ACR_NAME="acrcloudchampionmcp"
ACA_APP="mcp-cloudchampion"

# Build imagen en ACR
az acr build --registry $ACR_NAME --image mcp-cloudchampion:latest .

# Actualizar Container App con la nueva imagen
az containerapp update \
  --name $ACA_APP \
  --resource-group $RESOURCE_GROUP \
  --image "$ACR_NAME.azurecr.io/mcp-cloudchampion:latest"

3. Obtener URL

az containerapp show --name $ACA_APP --resource-group $RESOURCE_GROUP \
  --query "properties.configuration.ingress.fqdn" -o tsv

Personalizar parámetros

Edita infra/main.parameters.json para cambiar el nombre del ACR, CPU, memoria, réplicas, etc. Parámetros disponibles:

| Parámetro | Descripción | Default | |---|---|---| | acrName | Nombre del ACR (globalmente único) | acrcloudchampionmcp | | environmentName | Nombre del Container Apps Environment | env-cloudchampion-mcp | | appName | Nombre de la Container App | mcp-cloudchampion | | minReplicas | Mín. réplicas (0 = scale to zero) | 0 | | maxReplicas | Máx. réplicas | 3 | | cpu | CPU asignada | 0.25 | | memory | Memoria asignada | 0.5Gi | | cacheTtlSeconds | TTL de caché del feed | 600 | | logLevel | Nivel de logging | INFO |

CI/CD

El workflow de GitHub Actions (.github/workflows/deploy.yml) tiene dos jobs:

infra — Despliega Bicep (solo si cambian ficheros en infra/ o se lanza manualmente con deploy_infra: true)
build-and-deploy — Build de imagen en ACR + deploy a Container App (en cada push a main)

Requiere el secret AZURE_CREDENTIALS configurado en el repo.

Consumir el MCP

Desde VS Code / Claude Desktop

{
  "mcpServers": {
    "cloudchampion": {
      "url": "https://<tu-aca-url>.azurecontainerapps.io/mcp"
    }
  }
}

Desde un agente Python

from agents import Agent
from agents.mcp import MCPServerStreamableHttp

mcp = MCPServerStreamableHttp(url="https://<tu-aca-url>.azurecontainerapps.io/mcp")

agent = Agent(
    name="CloudChampionAssistant",
    instructions="Eres un asistente experto en formación de Cloud Champion...",
    mcp_servers=[mcp],
)

Variables de entorno

| Variable | Descripción | Default | |---|---|---| | CLOUDCHAMPION_FEED_URL | URL del feed de contenido | https://www.cloudchampion.es/wp-json/feed/content | | CACHE_TTL_SECONDS | TTL de la caché en segundos | 600 | | MCP_TRANSPORT | Transporte: streamable-http, sse, stdio | streamable-http | | MCP_HOST | Host de escucha | 0.0.0.0 | | MCP_PORT | Puerto de escucha | 8000 | | LOG_LEVEL | Nivel de logging | INFO |

Estructura del proyecto

├── src/
│   └── mcp_cloudchampion/
│       ├── __init__.py        # Versión del paquete
│       ├── __main__.py        # python -m entry point
│       ├── config.py          # Settings + logging setup
│       ├── text_utils.py      # Normalización de texto / fuzzy match
│       ├── feed_client.py     # Cliente HTTP + caché con TTL
│       ├── filters.py         # Motor de filtrado
│       └── server.py          # FastMCP server + 5 tools
├── Dockerfile                 # Multi-stage build
├── .dockerignore
├── .env.example
├── pyproject.toml
├── requirements.txt
├── README.md
└── .github/workflows/
    └── deploy.yml             # CI/CD → Azure Container Apps

Licencia

MIT

CloudChampion MCP Server