Magento 规范与标准（SSOT 和 MCP 服务器）

此仓库是 中央知识库（单一事实来源 - SSOT），涵盖 Magento 2.4.8-p5 / PHP 8.3 标准，并内置了 MCP Server Stdio。

此仓库 不包含流程或任务/功能管理。您可以将此 MCP 服务器连接到任何 Magento 项目，以便该项目的 AI 代理参考技术标准。

📌 结构

• config/ — 事实来源：

  • constitution.md — PHP 8.3 和 Magento 核心的技术标准。

  • checklist.md — 审查门禁和完成定义（DoD）的标准。

  • magento-patterns.md — 设计地图（插件、事件、GraphQL、REST、Admin 等）。

  • references/ — 各组件的详细代码示例指南。

  • glossary.md — Magento 核心术语。

• examples/ — 按主题分类的代码蓝图（进入 examples/INDEX.md 选择）。

• src/index.js — MCP 服务器（stdio）。

Related MCP server: Coding Tools MCP

⚡ MCP 服务器连接配置

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（环境变量）为可选 — 默认情况下服务器会自取仓库的根目录。仅当您将仓库放在其他位置并希望覆盖时才设置。

🛠️ 提供给 AI 的 MCP 工具

🔄 给 AI 代理的建议流程

1. 在编码前： get_team_standards → 加载宪法 + 检查清单 + 模式索引。

2. 在实现时： 使用 get_pattern_reference / search_standards / read_spec_file 查询模式 — 不要凭记忆猜测。

3. 在报告完成前： get_review_gate → 通过 checklist.md 中的第 12 节“审查门禁”。