Adobe Commerce MCP
This server gives an offline Adobe Commerce (Magento Open Source) PHP development assistant that searches bundled official docs and generates module scaffolding files without network access or credentials.
Search and read documentation: use
search-docsacross PHP, frontend, Web API, and operations docs, thenread-docto open full pages or sections by id, source path, or public URL.Explain configuration files:
explain-config-filedescribes files likedi.xml,events.xml,webapi.xml,db_schema.xml,crontab.xml,routes.xml,system.xml,acl.xml, layouts, and more, including location, XSD URN, and source docs.Look up bin/magento commands:
lookup-cli-commandreturns descriptions, usage, arguments, and options, accepting shortcuts and keywords.Look up Web APIs:
lookup-webapifinds REST endpoints and GraphQL queries/mutations, including parameters, return types, examples, and token requirements.Scaffold modules:
scaffold-modulegeneratesregistration.php,etc/module.xml, andcomposer.json.Add plugins:
add-plugingenerates before/after/around plugin classes and theirdi.xmldeclarations.Add observers:
add-observergenerates observer classes andevents.xmlsubscriptions.Add controllers and routes:
add-controllergeneratesroutes.xml, controllers, layouts/templates for pages, or JSON POST actions, including admin ACL files.Add database tables:
add-db-schemageneratesdb_schema.xmltables with columns, keys, indexes, foreign keys, and setup steps.Return files for the client to write: scaffolding tools return paths, contents, source doc references, and notes; the server itself never writes to disk or opens network connections.
Allows looking up Adobe Commerce GraphQL queries and mutations, including their arguments, return types, examples and related guides, alongside REST endpoint lookup from the OpenAPI schema.
Provides offline tooling for PHP development on Adobe Commerce (Magento): official Adobe documentation search and reading, explanation of XML config files (di.xml, events.xml, webapi.xml, db_schema.xml, layout, etc.), lookup of bin/magento CLI commands, and scaffolding of PHP modules, plugins, observers, controllers and db_schema tables that returns ready-to-write files with their source documentation reference.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Adobe Commerce MCP Create an Acme_Reviews module that depends on Magento_Catalog"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.

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-mcpRequiere 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.
Related MCP server: Magento 2 GraphQL Documentation MCP Server
Uso rápido
Reinicia el cliente y pide lo que necesitas en lenguaje natural. El asistente elige la herramienta:
"Crea el módulo
Acme_Reviewsque dependa deMagento_Catalog""Agrega un plugin after a
Magento\Catalog\Model\Product::getName""Dónde va el
system.xmly cuál es su XSD?""Crea la tabla
acme_reviewcon clave foránea acatalog_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, Codex, Cursor, Gemini CLI, GitHub Copilot, 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"]
}
}
}Codex, con el CLI (queda en ~/.codex/config.toml):
codex mcp add adobe-commerce -- npx -y @commenteme/adobe-commerce-mcpO a mano, en ~/.codex/config.toml o en .codex/config.toml del proyecto:
[mcp_servers.adobe-commerce]
command = "npx"
args = ["-y", "@commenteme/adobe-commerce-mcp"]Gemini CLI, con el CLI (-s user lo deja en ~/.gemini/settings.json; sin -s, en .gemini/settings.json del proyecto):
gemini mcp add -s user adobe-commerce npx -y @commenteme/adobe-commerce-mcpGitHub Copilot CLI, en ~/.copilot/mcp-config.json o en .mcp.json del proyecto, con el mismo JSON de mcpServers de arriba. En VS Code, Copilot usa el .vscode/mcp.json.
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
herramienta | parámetros | que hace |
|
| Busca en la documentación; |
|
| Devuelve una página completa o una sección, por id, ruta de origen o URL pública. |
|
| Explica un archivo de configuración: |
|
| Descripción, uso, argumentos y opciones de un comando de |
|
| Endpoints REST (parámetros, cuerpo, que token los llama) y queries y mutations de GraphQL (argumentos, retorno, ejemplo, guía). |
Scaffolding
herramienta | parámetros | que genera |
|
|
|
|
| La clase del plugin (before, after o around) y su |
|
| La clase del observer y su |
|
|
|
|
| La tabla en |
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/<Vendor>/<Module> 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
URI | contenido |
| Índice de la documentación por área y carpeta. |
| Una página, por ejemplo |
| Lista de los archivos de configuración del catálogo. |
| Repositorios, commits y licencias de los datos. |
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:
repositorio | licencia | que aporta |
Apache-2.0 | 807 páginas: extensiones PHP, arquitectura, tutoriales, estándares de código, referencia de módulos. | |
Apache-2.0 | 262 páginas: temas, layouts, templates, UI components, JavaScript, Page Builder. | |
Apache-2.0 | 532 páginas de guías REST y GraphQL, el esquema OpenAPI 2.4.9 y la referencia generada de GraphQL 2.4.9. | |
MIT | 295 páginas: configuración, CLI, instalación, rendimiento, seguridad, actualización y la referencia de |
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 locales, correos personales y nombres de clientes
data/ # generado: docs, cli.json, webapi/, config-files.json, licencias
test/ # node --test sobre el buildDesarrollo
npm install
npm run checkcomando | que hace |
| Compila TypeScript en |
| Verificación de tipos de |
| Pruebas con |
| Arranca el servidor compilado por stdio y falla si falta alguna herramienta esperada. |
| Busca rutas locales, correos personales y nombres de clientes fuera de |
| El gate: |
| Regenera |
| Abre el MCP Inspector sobre el build. |
Para probar la versión local en un cliente, apunta el comando a la build:
claude mcp add adobe-commerce-local -- node /ruta/a/adobe-commerce-mcp/build/index.jsConvenciones: TypeScript con módulos ESM; Prettier sin punto y coma y con comillas simples. Las descripciones de las herramientas van en inglés, porque es lo que el modelo lee para elegirlas. El conocimiento es de solo lectura en tiempo de ejecución: nada se escribe en disco ni se descarga.
Actualizar la documentación
Clona en una misma carpeta
AdobeDocs/commerce-php,commerce-frontend-core,commerce-webapiycommerce-operations.en(un clon superficial alcanza).Corre
npm run ingerir -- <carpeta>. El script solo lee los archivos de texto; nada de los clones se ejecuta.La ingestión falla si una entrada del catálogo de configuración cita una página que no existe o una URN que no aparece en sus fuentes.
Corre
npm run checky commiteadata/: el paquete lo necesita.
Ramas y publicación
El trabajo nace en una rama salida de dev y el PR va contra dev. Después de probar localmente, dev se promueve a main con merge de la rama completa (sin qa desde el 30/10/2026). El CI corre npm run check en Node 18, 20 y 22.
Para publicar, sube la versión en package.json, server.json y CHANGELOG.md y empuja un tag v*: el workflow publish.yml corre el gate, publica en npm con provenance, crea el GitHub Release y publica server.json en el MCP Registry. Los cambios de cada versión están en CHANGELOG.md.
Contribuir · Licencia
Abre un PR contra dev, con Conventional Commits y npm run check en verde.
MIT. Los datos de data/ conservan las licencias de sus fuentes (Apache-2.0 y MIT): mira NOTICE.
Hecho por commente.me · hablecon@commente.me
Available Tools
10 toolsadd-controllerAdd a controller and routeARead-onlyIdempotent
Generate routes.xml, an action controller (GET page or POST JSON) and, for pages, the layout handle and template, for the frontend or adminhtml area (with ADMIN_RESOURCE and acl.xml for the Admin), adapted from the official routing docs. Returns the files for the caller to write.
Inputs: area (required), module (required), frontName (required), title, +6 more. Returns: files, notes
add-db-schemaAdd a table to db_schema.xmlARead-onlyIdempotent
Generate a declarative schema etc/db_schema.xml table with columns, primary key, unique constraints, foreign keys and indexes, adapted from the official declarative schema docs, plus the whitelist and setup:upgrade steps. Returns the file for the caller to write.
Inputs: table (required), module (required), engine, unique, +7 more. Returns: files, notes
add-observerAdd an event observerARead-onlyIdempotent
Generate an observer class and its events.xml subscription (global or per area), adapted from the official events and observers docs. Returns the files for the caller to write. Use it to react to a dispatched event.
Inputs: event (required), module (required), area, basePath, +2 more. Returns: files, notes
add-pluginAdd a plugin (interceptor)ARead-onlyIdempotent
Generate a before, after or around plugin class and its di.xml declaration for a public method of a class or interface, adapted from the official plugins docs. Returns the files for the caller to write. Use it to change the behavior of a core or third-party method without rewriting the class.
Inputs: type (required), method (required), module (required), targetClass (required), +5 more. Returns: files, notes
explain-config-fileExplain a module config fileARead-onlyIdempotent
Explain an Adobe Commerce module configuration file (di.xml, events.xml, webapi.xml, db_schema.xml, crontab.xml, routes.xml, system.xml, acl.xml, config.xml, layout, ui_component, schema.graphqls, requirejs-config.js and more): what it is for, where it goes (folder and area), the XSD URN from the docs, and the documentation pages. Use it before creating or editing one of these files.
Inputs: file (required).
lookup-cli-commandLook up a bin/magento commandARead-onlyIdempotent
Look up a bin/magento command of Adobe Commerce on-premises: description, usage, arguments and options, from the official CLI reference. Accepts full names, Symfony shortcuts (s:up) or keywords. Use it before suggesting or running a bin/magento command.
Inputs: command (required).
lookup-webapiLook up REST endpoints and GraphQL operationsARead-onlyIdempotent
Look up Adobe Commerce Web API: REST endpoints (path, method, parameters, body, which tokens can call it) from the official OpenAPI schema, and GraphQL queries and mutations (arguments, return type, example, guide). Accepts a GraphQL name, a REST path or keywords. Use it when writing integrations or storefront calls.
Inputs: query (required), api, limit, method.
read-docRead an Adobe Commerce doc pageARead-onlyIdempotent
Read a full page, or one section, of the bundled Adobe Commerce documentation by id (from search-docs), source path or public developer.adobe.com / experienceleague.adobe.com URL. Use it after search-docs, or when the user pastes a docs link.
Inputs: ref (required), section.
scaffold-moduleScaffold an Adobe Commerce moduleARead-onlyIdempotent
Generate registration.php, etc/module.xml and composer.json for a new Adobe Commerce module (Vendor_Module), adapted from the official docs. Returns the files (path and content) for the caller to write; the server never writes to disk. Use it when starting a module.
Inputs: module (required), php, license, version, +4 more. Returns: files, notes
search-docsSearch Adobe Commerce docsARead-onlyIdempotent
Search the official Adobe Commerce (Magento Open Source) developer documentation bundled offline: PHP extensions, frontend core, Web APIs and operations. Use it first for any "how do I" question about modules, plugins, DI, events, declarative schema, layouts, caching, indexers, queues or configuration. Returns excerpts with title, public URL and source path; follow up with read-doc.
Inputs: query (required), area, limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool has a distinct role: docs search/read pair, two reference lookups (CLI vs Web API), and five generators targeting different artifacts. The only friction is that explain-config-file covers the same file types (di.xml, events.xml, db_schema.xml) that add-plugin, add-observer and add-db-schema generate, but the 'explain before creating' framing keeps the boundary readable.
All names are kebab-case verb_noun (explain-config-file, add-plugin, search-docs, lookup-webapi), which is predictable. Minor deviation: generators use three different verbs (add-, scaffold-, explain-) rather than one, so a new artifact type could plausibly be named either add- or scaffold-.
Ten tools for a large development domain is well-scoped; every tool maps to a real workflow step (research, lookup, generate). No filler or duplicate tools.
Core module lifecycle artifacts are covered (module skeleton, plugin, observer, controller/routes, db_schema) plus a solid offline docs and reference layer. Gaps remain for other common generators such as crontab.xml, console commands, system.xml admin config, UI components and GraphQL resolvers, though agents can hand-write these from the bundled docs.
Maintenance
Related MCP Connectors
Get up-to-date, version-specific documentation and code examples from official sources directly in…
Versioned documentation registry and semantic search for AI tools and coding assistants.
Provide your AI coding tools with token-efficient access to up-to-date technical documentation for…
Serves your design system and coding standards to coding agents, so they stop guessing.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI agents to interact with Magento 2 development environments through comprehensive tools for module management, database operations, cache control, configuration management, and system diagnostics. Supports complete development workflows from module creation to deployment and troubleshooting.28178 npm41MIT
- FlicenseAqualityDmaintenanceProvides offline search and retrieval of Magento 2 GraphQL API documentation with 8 specialized tools for finding queries, mutations, types, tutorials, and code examples across 350+ locally indexed markdown files.89-
- FlicenseAqualityDmaintenanceEnables searching and retrieving Magento 2 REST API documentation offline via local OpenAPI parsing, supporting endpoint search, schema lookup, and category browsing.57-
- AlicenseAqualityBmaintenanceTechnology-aware MCP server for Magento 2 and Adobe Commerce with intelligent indexing and search, enabling AI assistants to search, navigate, and understand codebases via semantic search and domain-specific pattern detection.4732 npm20MIT