io.github.commentemeappPublished by GitHub account commentemeappv0.2.0Updated Oct 30, 2026
Offline Adobe Commerce PHP docs, config files, bin/magento CLI, Web API and module scaffolding
Offline Adobe Commerce (Magento) PHP developer reference: searches bundled docs, explains config files, looks up CLI and Web API, and scaffolds module files.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Follow the launch instructions in the repository.
Servidor MCP para módulos de Adobe Commerce en PHP, sin red y sin credenciales.
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.
Reinicia el cliente y pide lo que necesitas en lenguaje natural. El asistente elige la herramienta:
Acme_Reviews que dependa de Magento_Catalog"Magento\Catalog\Model\Product::getName"system.xml y cuál es su XSD?"acme_review con clave foránea a catalog_product_entity"bin/magento setup:static-content:deploy?"addProductsToCart?"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.
bin/magento (2.4.9) con sus opciones, 614 endpoints REST del esquema OpenAPI y 225 queries y mutations de GraphQL.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ó.data/.Funciona con Claude Code, Claude Desktop, Cursor, VS Code, Windsurf y cualquier cliente MCP con transporte stdio.
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.
En claude_desktop_config.json (Claude Desktop), ~/.cursor/mcp.json o .cursor/mcp.json (Cursor) y ~/.codeium/windsurf/mcp_config.json (Windsurf):
En VS Code, .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.
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/<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.
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.
Para probar la versión local en un cliente, apunta el comando a la build:
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.
AdobeDocs/commerce-php, commerce-frontend-core, commerce-webapi y commerce-operations.en (un clon superficial alcanza).npm run ingerir -- <carpeta>. El script solo lee los archivos de texto; nada de los clones se ejecuta.npm run check y commitea data/: el paquete lo necesita.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.
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 · [email protected]
Source: README.md at commit ae87b7f
Search Adobe Commerce docs
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.
arealimitqueryrequiredRead an Adobe Commerce doc page
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.
refrequiredsectionExplain a module config file
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.
filerequiredLook up a bin/magento command
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.
commandrequiredLook up REST endpoints and GraphQL operations
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.
apilimitqueryrequiredmethodScaffold an Adobe Commerce module
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.
phpmodulerequiredlicenseversionbasePathsequencedescriptionpackageNameAdd a plugin (interceptor)
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.
areatyperequiredmethodrequiredmodulerequiredbasePathsortOrderpluginNamepluginClasstargetClassrequiredAdd an event observer
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.
areaeventrequiredmodulerequiredbasePathobserverNameobserverClassAdd a controller and route
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.
arearequiredtitleactionmethodmodulerequiredrouteIdbasePathfrontNamerequiredcontrolleraclResourceAdd a table to db_schema.xml
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.
tablerequiredenginemodulerequireduniquecolumnscommentindexesbasePathresourceprimaryKeyforeignKeys90% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
claude mcp add adobe-commerce -- npx -y @commenteme/adobe-commerce-mcp{ "mcpServers": { "adobe-commerce": { "command": "npx", "args": ["-y", "@commenteme/adobe-commerce-mcp"] } }}{ "servers": { "adobe-commerce": { "type": "stdio", "command": "npx", "args": ["-y", "@commenteme/adobe-commerce-mcp"] } }}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 BM25scripts/├── 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 clientesdata/ # generado: docs, cli.json, webapi/, config-files.json, licenciastest/ # node --test sobre el buildnpm installnpm run checkclaude mcp add adobe-commerce-local -- node /ruta/a/adobe-commerce-mcp/build/index.js