Magento Especificaciones y Estándares (SSOT y Servidor MCP)

Este repositorio es la Biblioteca de Conocimiento Central (Fuente Única de Verdad - SSOT) sobre el estándar Magento 2.4.8-p5 / PHP 8.3, con el Servidor MCP Stdio integrado.

Este repositorio no contiene procesos ni gestión de tareas/funcionalidades. Puedes conectar este Servidor MCP a cualquier proyecto Magento para que el Agente de IA de ese proyecto consulte los estándares técnicos.

📌 Estructura

• config/ — Fuente de la verdad:

  • constitution.md — Estándares técnicos de PHP 8.3 y Magento core.

  • checklist.md — Criterios de Puerta de Revisión y Definición de Hecho.

  • magento-patterns.md — Mapa de diseño (Plugin, Evento, GraphQL, REST, Admin...).

  • references/ — Guías de código de ejemplo detalladas para cada componente.

  • glossary.md — Terminología de Magento core.

• examples/ — Planos de código de muestra por tema (ve a examples/INDEX.md para elegir).

• src/index.js — Servidor MCP (stdio).

Related MCP server: Coding Tools MCP

⚡ Configuración de conexión del Servidor MCP

Claude Code (se recomienda ámbito user para que esté disponible en todos los proyectos):

claude mcp add magento-spec -s user -- node /path/to/spec/src/index.js

Cursor (~/.cursor/mcp.json), Antigravity (~/.gemini/antigravity/mcp_config.json) y otros clientes:

{
  "mcpServers": {
    "magento-spec": {
      "command": "node",
      "args": ["/path/to/spec/src/index.js"]
    }
  }
}

SPEC_ROOT (env) es opcional — por defecto el servidor toma la raíz del repositorio. Solo se establece cuando colocas el repositorio en otro lugar y deseas sobrescribirlo.

🛠️ Herramientas MCP proporcionadas a la IA

🔄 Proceso recomendado para el Agente de IA

1. Antes de codificar: get_team_standards → carga la Constitución + Lista de Verificación + índice de Patrones.

2. Al implementar: get_pattern_reference / search_standards / read_spec_file para consultar el patrón — no adivinar desde la memoria.

3. Antes de reportar como terminado: get_review_gate → pasar la §12 Puerta de Revisión en checklist.md.