io.github.commentemeapp由 GitHub 帳號 commentemeapp 發布v0.2.0更新於 Oct 30, 2026
Offline Adobe Commerce PHP docs, config files, bin/magento CLI, Web API and module scaffolding
離線 Adobe Commerce（Magento）PHP 開發參考：檢索內建文件、說明設定檔、查詢 CLI 與 Web API，並產生模組骨架檔案。
Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。
參照 儲存庫 中的啟動說明。
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]
來源：README.md，提交 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.
arealimitquery必填Read 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.
ref必填sectionExplain 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.
file必填Look 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.
command必填Look 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.
apilimitquery必填methodScaffold 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.
phpmodule必填licenseversionbasePathsequencedescriptionpackageNameAdd 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.
areatype必填method必填module必填basePathsortOrderpluginNamepluginClasstargetClass必填Add 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.
areaevent必填module必填basePathobserverNameobserverClassAdd 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.
area必填titleactionmethodmodule必填routeIdbasePathfrontName必填controlleraclResourceAdd 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.
table必填enginemodule必填uniquecolumnscommentindexesbasePathresourceprimaryKeyforeignKeys已滿足適用檢查項的 90%
該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。
請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。
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