Entidadactivecreado Wed May 13#mcp #cloudflare #workers #github #ci #observability #reliability #infra

Tool MCP: `github_list_workflow_runs`

Descripción

Tool del servidor MCP de CreaRack-Workspace que permite listar runs de GitHub Actions de los repositorios del ecosistema CreaRack. Añadida en el commit 92da366 (2026-05-13) para cubrir la necesidad del Agente Mantenimiento Semanal de auditar el estado de CI/CD y detectar regresiones persistentes.

Parámetros

Parámetro	Tipo	Requerido	Default	Descripción
`repo`	`string`	No	`CreaRack-Pro`	Nombre del repositorio. Debe estar en la allowlist (`ALLOWED_REPOS`).
`workflow`	`string`	No	—	Nombre/filename del workflow (ej: `pip-audit.yml`, `ci.yml`). Si se omite, lista runs de todos los workflows.
`status`	`enum`	No	—	Filtro por estado: `queued`, `in_progress`, `completed`, `failure`, `success`.
`limit`	`number`	No	`10`	Máximo de runs a retornar. Tope: `50`.

Respuesta

{
  "repo": "CreaRack-Pro",
  "workflow": "pip-audit.yml",
  "total_count": 42,
  "runs": [
    {
      "id": 12345678,
      "name": "Security Audit (pip-audit)",
      "workflow_id": 987654,
      "event": "schedule",
      "status": "completed",
      "conclusion": "success",
      "head_branch": "main",
      "head_sha": "92da366",
      "created_at": "2026-05-13T18:00:00Z",
      "updated_at": "2026-05-13T18:05:00Z",
      "run_attempt": 1,
      "html_url": "https://github.com/CreaRackSL/CreaRack-Pro/actions/runs/12345678"
    }
  ]
}

Implementación

Handler: functions/api/mcp/handlers/github.ts, case github_list_workflow_runs
Definición del schema: functions/api/mcp/tools.ts
Validación de repo: functions/api/mcp/validation.ts → isAllowedRepo()
Endpoints GitHub API usados:
- Con workflow: GET /repos/CreaRackSL/{repo}/actions/workflows/{workflow}/runs
- Sin workflow: GET /repos/CreaRackSL/{repo}/actions/runs
Autenticación: GH_PAT (Personal Access Token, secret del Worker)

Repos permitidos (ALLOWED_REPOS)

A partir de este commit, la allowlist incluye:

const ALLOWED_REPOS = ['CreaRack-Pro', 'CreaRackSL-workspace', 'claude-method'];

claude-method fue añadido en el mismo commit para que el agente pueda consultar issues/PRs/actividad de los tres repos del ecosistema.

Casos de uso

Auditoría pip-audit: verificar que los runs de seguridad pasan en CreaRack-Pro.
Detección de regresiones CI persistentes: Tarea 6 del Agente Mantenimiento Semanal.
Estado de workflows tras un merge: comprobar si un push a main disparó y completó correctamente el CI.
Troubleshooting: filtrar por status=completed&conclusion=failure para ver runs fallidos recientes.

Notas y limitaciones

Límite máximo: 50 runs por llamada (hardcoded en el handler).
Sin paginación: no soporta cursor/page. Para auditorías extensas, usar directamente la API de GitHub.
Requiere GH_PAT: si el secret no está configurado en el Worker, devuelve { error: 'GH_PAT not configured' }.
Repo implícito: si no se pasa repo, asume CreaRack-Pro. Los agentes deben pasar repo explícito al consultar CreaRackSL-workspace o claude-method.
Pendiente: actualizar el prompt de maintenance-weekly para usar los nombres exactos de las tools MCP (no las del entorno Claude Code) y pasar repo: explícito.

Véase también

[[workspace—agentes-ia]]
[[workspace—que-es-workspace]]
[[entity—mcp—handler—github]]

Referenciado desde

Handler MCP: GitHub (github.ts)

Tool MCP: github_list_workflow_runs