CloudScope MCP

Pregunta a tu IA sobre tu factura de la nube.

npm version Node.js TypeScript License: MIT

Instalación

Claude Code	Cursor	VS Code
`claude mcp add cloudscope -- npx -y cloudscope-mcp`	Instalar	Instalar

Qué hace

CloudScope proporciona a los asistentes de IA acceso de solo lectura a tus datos de costes de Azure. Pregunta sobre el gasto, encuentra anomalías, obtén recomendaciones de optimización y prevé la factura del próximo mes, todo mediante lenguaje natural.

Proveedores compatibles

Proveedor	Estado
Azure	✅ Compatible
GCP	Próximamente
AWS	Usa el servidor oficial de AWS

Requisitos previos

Azure CLI instalado e iniciada la sesión (az login)
Tu ID de suscripción (az account show --query id -o tsv)
Rol de Lector de Cost Management en la suscripción

Configuración

Añádelo a la configuración de tu cliente MCP (claude_desktop_config.json, ajustes de Cursor, etc.):

{
  "mcpServers": {
    "cloudscope": {
      "command": "npx",
      "args": ["-y", "cloudscope-mcp"],
      "env": {
        "AZURE_SUBSCRIPTION_ID": "your-subscription-id"
      }
    }
  }
}

No se necesita una entidad de servicio para el desarrollo local. DefaultAzureCredential detecta automáticamente tu sesión de az login.

Variable	Descripción
`AZURE_TENANT_ID`	ID de inquilino de Azure AD
`AZURE_CLIENT_ID`	ID de cliente de registro de la aplicación
`AZURE_CLIENT_SECRET`	Secreto de cliente de registro de la aplicación

Configura esto junto con AZURE_SUBSCRIPTION_ID en el bloque env anterior.

Herramientas

Herramienta	Descripción	Parámetros clave
`get_cost_summary`	Desglose de gastos por servicio, grupo o región	`start_date`, `end_date`, `group_by`
`detect_anomalies`	Encuentra picos de gasto frente al periodo anterior	`days`, `threshold`
`list_recommendations`	Sugerencias de optimización de costes de Azure Advisor	`category`
`get_cost_forecast`	Predice el gasto basado en las tendencias actuales	`days`
`check_budgets`	Estado del presupuesto, gasto actual, exceso proyectado	(ninguno)
`compare_periods`	Comparación de costes lado a lado de dos rangos de fechas	`period_a_start/end`, `period_b_start/end`
`top_spending_resources`	Recursos individuales más costosos	`days`, `limit`
`get_current_date`	Fecha de hoy y límites del mes actual/anterior	(ninguno)

Ejemplos de prompts

"¿Cuánto costó Azure el mes pasado?"
"Muestra el gasto por grupo de recursos de los últimos 7 días"
"¿Hay alguna anomalía de costes esta semana?"
"¿Cuánto costará Azure el próximo mes?"
"Muéstrame recomendaciones de optimización de costes"
"¿Qué servicios tuvieron el mayor aumento de gasto?"

Seguridad

CloudScope es de solo lectura. No puede crear, modificar ni eliminar ningún recurso de Azure. Todas las llamadas a la API utilizan permisos de Lector de Cost Management sin acceso de escritura.

Preguntas frecuentes

¿Esto modifica mis recursos de Azure? No. Solo acceso de lectura.

¿Necesito una entidad de servicio? No. az login funciona para uso local.

¿Qué pasa con GCP? Próximamente.

¿La API de Azure Cost Management cuesta dinero? No. Es gratuita.

Desarrollo

git clone https://github.com/alexpota/cloudscope-mcp.git
cd cloudscope-mcp
npm install
npm run build
npm test
npx @modelcontextprotocol/inspector node dist/index.js