Skip to main content
Glama

adobe-commerce-mcp · Servidor MCP para módulos de Adobe Commerce en PHP, sin red y sin credenciales

adobe-commerce-mcp

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

npm node license

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.

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_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, 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-mcp

O 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-mcp

GitHub 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

search-docs

query, area?, limit?

Busca en la documentación; area es php, frontend, webapi u operations. Devuelve extractos con título, URL y ruta de origen.

read-doc

ref, section?

Devuelve una página completa o una sección, por id, ruta de origen o URL pública.

explain-config-file

file

Explica un archivo de configuración: di.xml, events.xml, webapi.xml, db_schema.xml, crontab.xml, routes.xml, system.xml, acl.xml, layout y 32 mas.

lookup-cli-command

command

Descripción, uso, argumentos y opciones de un comando de bin/magento; acepta atajos (s:up) y palabras clave.

lookup-webapi

query, api?, method?, limit?

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

scaffold-module

module, description?, packageName?, version?, license?, sequence?, php?, basePath?

registration.php, etc/module.xml y composer.json.

add-plugin

module, targetClass, method, type, pluginClass?, pluginName?, area?, sortOrder?, basePath?

La clase del plugin (before, after o around) y su di.xml.

add-observer

module, event, observerClass?, observerName?, area?, basePath?

La clase del observer y su events.xml.

add-controller

module, area, frontName, routeId?, controller?, action?, method?, title?, aclResource?, basePath?

routes.xml y el controller (página GET o JSON por POST); para páginas, el layout y el template; en adminhtml, ADMIN_RESOURCE y acl.xml.

add-db-schema

module, table, columns?, primaryKey?, unique?, indexes?, foreignKeys?, comment?, resource?, engine?, basePath?

La tabla en etc/db_schema.xml, con los pasos del whitelist y de setup:upgrade.

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

adobe-commerce://docs

Índice de la documentación por área y carpeta.

adobe-commerce://docs/{id}

Una página, por ejemplo adobe-commerce://docs/php/development/components/plugins.md.

adobe-commerce://config-files

Lista de los archivos de configuración del catálogo.

adobe-commerce://sources

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

AdobeDocs/commerce-php

Apache-2.0

807 páginas: extensiones PHP, arquitectura, tutoriales, estándares de código, referencia de módulos.

AdobeDocs/commerce-frontend-core

Apache-2.0

262 páginas: temas, layouts, templates, UI components, JavaScript, Page Builder.

AdobeDocs/commerce-webapi

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.

AdobeDocs/commerce-operations.en

MIT

295 páginas: configuración, CLI, instalación, rendimiento, seguridad, actualización y la referencia de bin/magento.

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 build

Desarrollo

npm install
npm run check

comando

que hace

npm run build

Compila TypeScript en build/ y marca el binario como ejecutable.

npm run lint

Verificación de tipos de src/ y scripts/.

npm test

Pruebas con node --test sobre el build.

npm run probar-mcp

Arranca el servidor compilado por stdio y falla si falta alguna herramienta esperada.

npm run rastros

Busca rutas locales, correos personales y nombres de clientes fuera de node_modules.

npm run check

El gate: prettier --check, lint, build, pruebas, probar-mcp y rastros.

npm run ingerir -- <carpeta>

Regenera data/ a partir de los clones (también con FONTES_DIR).

npm run inspect

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.js

Convenciones: 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

  1. Clona en una misma carpeta AdobeDocs/commerce-php, commerce-frontend-core, commerce-webapi y commerce-operations.en (un clon superficial alcanza).

  2. Corre npm run ingerir -- <carpeta>. El script solo lee los archivos de texto; nada de los clones se ejecuta.

  3. 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.

  4. Corre npm run check y commitea data/: 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 tools
add-controllerAdd a controller and routeA
Read-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.xmlA
Read-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 observerA
Read-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)A
Read-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 fileA
Read-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 commandA
Read-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 operationsA
Read-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 pageA
Read-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 moduleA
Read-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 docsA
Read-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

    A4.1/5.0

    Scored across 10 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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-.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables 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.
      28
      178 npm
      41
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Provides 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.
      8
      9
      -
    • A
      license
      A
      quality
      B
      maintenance
      Technology-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.
      47
      32 npm
      20
      MIT