Magento Spec & Standards (SSOT & MCP Server)

This repo is a Central Knowledge Library (Single Source of Truth - SSOT) for Magento 2.4.8-p5 / PHP 8.3 standards, with a built-in MCP Server Stdio.

This repo does not contain processes or task/feature management. You can connect this MCP Server to any Magento project so that the AI Agent in that project can reference the technical standards.

📌 Structure

• config/ — Source of truth:

  • constitution.md — PHP 8.3 & Magento core technical standards.

  • checklist.md — Review Gate & DoD criteria.

  • magento-patterns.md — Design map (Plugin, Event, GraphQL, REST, Admin...).

  • references/ — Detailed code sample guides for each component.

  • glossary.md — Magento core terminology.

• examples/ — Sample code blueprints by topic (see examples/INDEX.md to choose).

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

Related MCP server: Coding Tools MCP

⚡ MCP Server Connection Configuration

Claude Code (recommended scope user to be available in all projects):

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

Cursor (~/.cursor/mcp.json), Antigravity (~/.gemini/antigravity/mcp_config.json) and other clients:

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

SPEC_ROOT (env) is optional — by default the server takes the repo's root directory. Only set if you place the repo elsewhere and want to override.

🛠️ MCP Tools Provided to AI

🔄 Recommended Workflow for AI Agent

1. Before coding: get_team_standards → load Constitution + Checklist + Pattern index.

2. When implementing: get_pattern_reference / search_standards / read_spec_file to look up patterns — do not guess from memory.

3. Before reporting done: get_review_gate → go through §12 Review Gate in checklist.md.