Magento 사양 및 표준 (SSOT 및 MCP 서버)

이 저장소는 Magento 2.4.8-p5 / PHP 8.3 표준에 대한 **중앙 지식 라이브러리(Single Source of Truth - SSOT)**이며, MCP Server Stdio가 내장되어 있습니다.

이 저장소는 프로세스나 작업/기능 관리를 포함하지 않습니다. 이 MCP Server를 모든 Magento 프로젝트에 연결하여 해당 프로젝트의 AI Agent가 기술 표준을 참조할 수 있습니다.

📌 구조

• config/ — 진실의 원천:

  • constitution.md — PHP 8.3 및 Magento 코어 기술 표준.

  • checklist.md — Review Gate 및 DoD 기준.

  • magento-patterns.md — 설계 맵(Plugin, Event, GraphQL, REST, Admin...).

  • references/ — 각 구성 요소에 대한 상세 코드 예제 가이드.

  • glossary.md — Magento 코어 용어.

• examples/ — 주제별 샘플 코드 청사진(examples/INDEX.md에서 선택).

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

Related MCP server: Coding Tools MCP

⚡ MCP Server 연결 구성

Claude Code (모든 프로젝트에서 사용할 수 있도록 user 범위 권장):

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

Cursor (~/.cursor/mcp.json), Antigravity (~/.gemini/antigravity/mcp_config.json) 및 기타 클라이언트:

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

SPEC_ROOT (env)는 선택 사항입니다. 기본적으로 서버는 저장소의 루트 디렉토리를 자동으로 가져옵니다. 저장소를 다른 위치에 배치하고 재정의하려는 경우에만 설정하세요.

🛠️ AI에 제공되는 MCP 도구

🔄 AI Agent 권장 프로세스

1. 코드 작성 전: get_team_standards → Constitution + Checklist + Pattern index를 로드합니다.

2. 구현 시: get_pattern_reference / search_standards / read_spec_file을 사용하여 패턴을 조회합니다. 메모리에서 추측하지 마십시오.

3. 완료 보고 전: get_review_gate → checklist.md의 §12 Review Gate를 통과합니다.