Adobe Commerce MCP

adobe-commerce-mcp

Servidor MCP para módulos de Adobe Commerce en PHP, sin red y sin credenciales.

Instalación

claude mcp add adobe-commerce -- npx -y @commenteme/adobe-commerce-mcp

Requiere Node >= 18. El cliente ejecuta el servidor con npx, así que no hace falta instalarlo. Para Claude Desktop, Cursor, Windsurf, VS Code y otros clientes, mira Otros clientes.

Uso rápido

Reinicia el cliente y pide lo que necesitas en lenguaje natural. El asistente elige la herramienta:

• "Crea el módulo Acme_Reviews que dependa de Magento_Catalog"
• "Agrega un plugin after a Magento\Catalog\Model\Product::getName"
• "Dónde va el system.xml y cuál es su XSD?"
• "Crea la tabla acme_review con clave foránea a catalog_product_entity"
• "Que opciones tiene bin/magento setup:static-content:deploy?"
• "Que argumentos recibe la mutation addProductsToCart?"

Que incluye

Para quien escribe módulos de Adobe Commerce (Magento Open Source) en PaaS o en servidor propio: di.xml, plugins, observers, layout, db_schema.xml, webapi.xml y el resto del día a día en PHP.

• Documentación oficial offline: 1.896 páginas de cuatro repositorios de AdobeDocs, con búsqueda BM25 por secciones. Cada resultado trae título, URL pública y ruta en el repositorio de origen.
• Archivos de configuración: que es cada uno, dónde va (carpeta y área), la URN del XSD cuando la documentación la da y las páginas que lo explican.
• CLI y Web API: los 147 comandos de bin/magento (2.4.9) con sus opciones, 614 endpoints REST del esquema OpenAPI y 225 queries y mutations de GraphQL.
• Scaffolding: módulo, plugin, observer, controller y tabla de db_schema.xml. Las herramientas devuelven los archivos (ruta y contenido) para que el cliente los escriba, y cada archivo dice de que página de la documentación salió.
• Local y sin credenciales: no abre conexiones, no pide login y no escribe en disco. Todo el conocimiento está en data/.

Funciona con Claude Code, Claude Desktop, Cursor, VS Code, Windsurf y cualquier cliente MCP con transporte stdio.

Por que existe

El MCP oficial de Adobe, @adobe-commerce/commerce-extensibility-tools, cubre el desarrollo con App Builder (comandos aio). Pide iniciar sesión en Adobe IMS (aio auth login), incluso para buscar documentación; su licencia es propietaria (EULA), y una de sus herramientas envía el historial de la conversación a Adobe. Si desarrollas con App Builder, ocupa ese. Para el desarrollo en PHP no hay servidor oficial: este cubre ese caso con la documentación pública de Adobe Commerce, licencia MIT, sin cuenta y sin red.

Documentación

Otros clientes

En claude_desktop_config.json (Claude Desktop), ~/.cursor/mcp.json o .cursor/mcp.json (Cursor) y ~/.codeium/windsurf/mcp_config.json (Windsurf):

{

"mcpServers": { "adobe-commerce": { "command": "npx", "args": ["-y", "@commenteme/adobe-commerce-mcp"] } } }

En VS Code, .vscode/mcp.json:

{

"servers": { "adobe-commerce": { "type": "stdio", "command": "npx", "args": ["-y", "@commenteme/adobe-commerce-mcp"] } } }

Cualquier cliente con transporte stdio sirve: el comando es npx y los argumentos, -y @commenteme/adobe-commerce-mcp. Con una instalación global (npm install -g @commenteme/adobe-commerce-mcp), el comando es adobe-commerce-mcp. En Claude Code, --scope project deja la configuración en .mcp.json para compartirla con el equipo.

Herramientas

La entrada src/index.ts conecta el servidor por stdio, y las diez herramientas se registran en src/tools/index.ts.

Documentación y referencia

Scaffolding

Las herramientas de scaffolding devuelven también structuredContent con files (path, content, source) y notes. Las rutas son relativas a la raíz de la instalación (app/code/ / por defecto). La herramienta no ve el módulo: si el archivo ya existe, el nodo nuevo se fusiona con lo que hay, y las notas lo avisan.

Resources

De dónde vienen los datos

Todo sale de los repositorios públicos de documentación de Adobe Commerce, en el commit fijado en data/fonte.json:

Quedaron fuera las notas de versión, las mas de 900 páginas de parches del Quality Patches Tool, las herramientas de monitoreo en la nube y la referencia de GraphQL de versiones anteriores. El código y los XSD de magento/magento2 no se usan: su licencia (OSL-3.0) no es compatible con la MIT de este paquete. Los templates de scaffolding se adaptaron de los ejemplos de la documentación.

Las licencias de las fuentes van en data/licenses/ y el detalle, en NOTICE. Este proyecto no está afiliado a Adobe ni cuenta con su respaldo.

Estructura

src/

├── index.ts # entry point del binario (stdio) ├── server.ts # McpServer: registra tools y resources ├── tools/ # una herramienta por archivo, registradas en tools/index.ts ├── scaffold/ # validación de nombres y formato de los archivos generados ├── resources/ # adobe-commerce://docs, config-files y sources └── knowledge/ # carga de data/ y búsqueda BM25 scripts/ ├── ingerir.ts # genera data/ a partir de los clones de AdobeDocs ├── catalogo-config.ts # catálogo de archivos de configuración, con sus fuentes ├── probar-mcp.mjs # arranca el servidor por stdio y comprueba las herramientas └── rastros.mjs # busca rutas local