# @adobe-commerce/commerce-extensibility-tools 中文文档

规范地址：https://npmcn.com/package/%40adobe-commerce/commerce-extensibility-tools/

版本：3\.6\.0
npm 元数据更新时间：2026-09-29T09:47:28.043Z
中文译文更新时间：2026-11-06T08:16:59.483Z
软件包许可：SEE LICENSE IN LICENSE

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40adobe-commerce/commerce-extensibility-tools
原文对照：https://npmcn.com/package/%40adobe-commerce/commerce-extensibility-tools/?lang=original
项目主页：https://github.com/adobe-commerce/commerce-extensibility-tools#readme
源码仓库：https://github.com/adobe-commerce/commerce-extensibility-tools

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.1 MB，135 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.0\.0
- 运行依赖：6 个
- 首次发布：2025-08-28T15:19:01.449Z
- 最新版本发布：2026-09-29T09:47:27.848Z
- 近 30 天下载量：3925（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：26（近 12 个月 19 个）

## 中文简介

MCP 服务器为 AI 动力开发提供 Adobe Commerce 扩展工具

## 安装

```sh
npm install @adobe-commerce/commerce-extensibility-tools
```

也可以使用：`pnpm add @adobe-commerce/commerce-extensibility-tools`、`yarn add @adobe-commerce/commerce-extensibility-tools`、`bun add @adobe-commerce/commerce-extensibility-tools`

## README

# Adobe 商业扩展工具

MCP(模式上下文协议)服务器为Adobe Commerce App Builder扩展开发提供AI动力工具. 与Cursor IDE和其他MCP相容的AI助手合作.

## ~ 这能做什么 ~

这个 MCP 服务器允许您的 AI 助手( 如 Cursor) 直接访问 Adobe Commerce 开发工具 :

-   部署和管理 Adobe I/O 应用程序
-   订阅商务活动
-   使用 AI 驱动的 RAG 搜索商务文件
-   配置 Adobe I/O 项目
-   上传反馈和聊天历史(带有IMS认证)
-   **AI 代理技能** 用于指导扩展开发(建筑、编码、测试、部署等)

## · 先决条件

在安装前,请确定您有:

1.  **光标 IDE** (或另一种与MCP相容的 IDE)
2.  **节点.js 22+** (LTS建议)
3.  **Adobe I/O 语录** 全球安装:
    
    ```bash
    npm install -g @adobe/aio-cli
    ```
    
4.  **Adobe IMS 认证** (文件搜索和反馈上传需要):
    
    ```bash
    aio auth login
    ```
    

## \* 安装

### 第1步:克隆并安装

```bash
# Clone this repository
git clone https://github.com/adobe-commerce/commerce-extensibility-tools.git
cd commerce-extensibility-tools

# Install dependencies
npm install
```

### 步骤2: 配置光标 IDE

创建或更新 `.cursor/mcp.json` **在您的商务项目目录中** (不是全球):

```json
{
  "mcpServers": {
    "commerce-extensibility": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/commerce-extensibility-tools/index.js"
      ],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}
```

**重要**替换 `/ABSOLUTE/PATH/TO/` 与您克隆此寄存器的实际路径.

**示例** (马克OS/Linux):

```json
{
  "mcpServers": {
    "commerce-extensibility": {
      "command": "node",
      "args": [
        "/Users/yourname/projects/commerce-extensibility-tools/index.js"
      ]
    }
  }
}
```

**示例** (温道:

```json
{
  "mcpServers": {
    "commerce-extensibility": {
      "command": "node",
      "args": [
        "C:\\Users\\yourname\\projects\\commerce-extensibility-tools\\index.js"
      ]
    }
  }
}
```

### 步骤3:复制AI规则(备选但推荐)

将光标规则复制到您的项目中, 以便更好的 AI 帮助 :

```bash
# From your Commerce project directory
cp -r /path/to/commerce-extensibility-tools/rules/Cursor/ .cursor/rules/
```

这些规则教会AI助手关于Adobe Commerce的最佳做法和工作流程.

### 第4步:设置光标命令(可选但推荐)

将预配置的光标命令复制到您的项目, 以便快速访问 MCP 工具 :

```bash
# From your Commerce project directory
mkdir -p .cursor/commands
cp /path/to/commerce-extensibility-tools/commands/Cursor/* .cursor/commands/
```

**这有什么作用:**

-   在光标 IDE 中创建快捷键命令(例如, `@search-commerce-docs`, (中文(简体) ), `@aio-app-deploy`(中文(简体) )
-   提供快速访问所有 MCP 工具而不输入完整工具名称
-   更容易发现和使用可用的多CP工具

**可用命令 :**

-   `@search-commerce-docs` - 搜索Adobe商业文件
-   `@aio-app-deploy` - 部署Adobe I/O App
-   `@aio-app-dev` - 启动本地开发服务器
-   `@aio-app-use` - 配置运行时命名空间
-   `@aio-configure-global` - 改变全球Adobe I/O配置
-   `@aio-dev-invoke` - 启动本地运行时间行动
-   `@aio-login` - 登录到Adobe I/ 欧
-   `@aio-where` - 显示当前配置
-   `@commerce-event-subscribe` - 订阅商务活动
-   `@onboard` - 配置事件提供者

**说明:** 其他IDE(VSCode, Claude Desktop)可能在未来支持类似的指令系统. 检查 `commands/` iDE特定命令文件的目录.

### 第5步:重新启动光标

完全退出并重新启动 Cursor IDE 以加载 MCP 服务器 .

### 步骤6:核查安装

在 Cursor 中,您应该看到 MCP 服务器已激活 。 试问:

```
"Can you show me the available Adobe Commerce tools?"
```

## 可用的工具

MCP 服务器提供 **11个工具** 财务报告和审定财务报表 **2个提示**数字 :

> **说明**:所有工具都支持方案使用和互动提示。 提示提供了更方便用户的方式,通过自然语言与工具互动.

### Adobe I/O 应用程序管理

| 工具 | 说明 |
| --- | --- |
| `aio-app-deploy` | 部署 Adobe I/O App 运行时间( 全部应用或具体行动) |
| `aio-app-dev` | 启动本地开发服务器进行测试 |
| `aio-app-use` | 为当前工程配置运行时间命名空间 |
| `aio-dev-invoke` | 在开发期间在当地启动运行时间行动 |

### Adobe I/ O 配置

| 工具 | 说明 |
| --- | --- |
| `aio-login` | 以 Adobe I/ O( OAuth2 流量) 认证 |
| `aio-where` | 显示当前 Adobe I/O 配置( org/ project/ workspace) |
| `aio-configure-global` | 管理全局 Adobe I/ O 配置 |

### 商业一体化

| 工具 | 说明 |
| --- | --- |
| `onboard` | 配置 Adobe I/O 事件提供者和商务事件模块 |
| `commerce-event-subscribe` | 订阅商务活动(产品、客户、订单等) |

### 文档搜索

| 工具 | 说明 |
| --- | --- |
| `search-commerce-docs` | 使用 AI 动力RAG 的搜索商务和 App 构建器文档 |

### 反馈和支持

| 工具 | 说明 |
| --- | --- |
| `upload-chat-history` | 上传聊天历史和用户反馈到反馈服务. 需要通过 IMS 认证 `aio auth login`。 。 。 . |

### MCP 提示

MCP服务器为增强用户交互提供了以下提示:

| 提示 | 说明 |
| --- | --- |
| `search` | 代理阿多比商业文献查询. 使用 `search-commerce-docs`,探索结果,获取链接页面,并对开发者进行任何主题的交互式教育. |
| `feedback` | 收集用户对其经验的反馈,包括错误、问题、建议和一般性评论。 对话历史被自动收集,进行消毒以去除敏感数据,并随反馈一起上传来帮助改进服务. |

## AI 代理技能

该项目包括: **7 人工智能代理技能** 与集成启动套件捆绑在一起( U)`dist/integration-starter-kit/skills/`) (中文(简体) ). 这些技能提供了专门的、以角色为基础的指导,AI助理人员可以遵循这些指导,在推广发展的各个阶段提供专家一级的帮助.

### 现有技能

| 技能 | 说明 |
| --- | --- |
| **产品管理器** | 收集和文件要求,确定接受标准,并建立要求 |
| **建筑师** | 设计扩展架构,选择事件,规划数据流,并生产ARCHITECTURE.md |
| **开发者** | 按照 6 文件处理器结构和 App 构建器模式执行运行时间动作 |
| **测试器** | 创建单位和集成测试,验证安全性,并确保代码质量和覆盖范围 |
| **DevOps 工程师** | 操作部署、CI/CD配置、脚手架清理和故障排除 |
| **技术作家** | 写入 README 文件、用户指南、 API 文档和更改日志 |
| **教师** | 教Adobe Commerce和 App Builder 概念,并有清晰的解释和实例 |

### 技能如何运作

每个技能都是结构化的标记下文件(`SKILL.md`)与YAML前题,定义了技能的名称,描述,角色,以及工作流程. 人工智能代理人读取技能时,采用被定义的人a并遵循规定的程序.

技能的设计是为了在发展工作流程中共同努力:

```
Product Manager → Architect → Developer → Tester → DevOps Engineer → Technical Writer
```

这个 **一般事务人员(其他职等)** 在集成起步器 Kit 中的文件充当了主管弦乐手,引用所有技能,并协调他们之间的交接.

### 安装技能

复制技能和支持文件到您的商务项目 :

```bash
# From your Commerce project directory
cp -r /path/to/commerce-extensibility-tools/dist/integration-starter-kit/skills/ skills/
cp /path/to/commerce-extensibility-tools/dist/integration-starter-kit/AGENTS.md AGENTS.md

# Optional: copy reference schemas and examples
cp -r /path/to/commerce-extensibility-tools/dist/integration-starter-kit/references/ references/
cp -r /path/to/commerce-extensibility-tools/dist/integration-starter-kit/examples/ examples/
```

技能由支持AGENTS.md常规的AI助手自动使用(Cursor, Claude Code, GitHub Copilot等). 您也可以直接参考个人技能,将您的人工智能助手指向相关 `SKILL.md` 文档.

## 文件搜索(RAG系统)

这个 `search-commerce-docs` 工具提供由 Azure RAG 提供的智能文档搜索 **自动选择索引**数字 :

### 可用文档索引

| 指数 | 内容 | 自动选定关键字 |
| --- | --- | --- |
| **商业-商店前期文件** | 边快递服务、快递、存储前置组件 | 商店前端、入站、电子数据交换、产品上市、出站 |
| **商业推广-文献** | Webhooks, 事件, 扩展, 集成 | webhook, 事件, 扩展名, API mesh, GraphQL |
| **商业核心文件** | 核心商业(目录、客户、订单) | 目录、产品、客户、订单、库存 |
| **应用程序构建器** | App 构建器、运行时间动作、 UI 扩展 | 应用程序构建器、 运行时动作、 反应光谱 |

### 如何运作

1.  **自动认证**: 使用您的 `aio` CLI 令牌( 从 `aio auth login`(中文(简体) )
2.  **智能索引选择**: 根据您的查询关键字自动选择最佳文档索引
3.  **IMS 认证**: 通过 Adobe IMS 进行安全认证
4.  **AI 授权搜索**: 语义搜索综合文献
5.  **即时结果**: 在~2秒内返回最相关的前5名

### 光标中的使用

**自动选择索引** (建议): 仅问自然语言问题,工具会自动搜索正确的文档:

```
"How do I use Edge Delivery Services drop-ins for product listing?"
→ Auto-selects: commerce-storefront-docs

"How do I create a webhook in Adobe Commerce?"
→ Auto-selects: commerce-extensibility-docs

"How to configure product catalog settings?"
→ Auto-selects: commerce-core-docs

"What are App Builder runtime action best practices?"
→ Auto-selects: app-builder-docs
```

**明确的索引选择** (高级): 也可以指定要搜索的索引 :

```
"Search commerce-storefront-docs for authentication drop-in"
"Using app-builder-docs, how do I deploy runtime actions?"
```

AI将自动使用搜索工具并用最合适的索引提供相关文档.

## 使用量

安装后,可以使用两种方式:

### 备选案文1:自然语言(建议)

用自然语言询问光标, 它会自动使用正确的工具 :

```
"Deploy my Adobe Commerce extension to production"
→ AI uses: aio-app-deploy

"Start the local development server"
→ AI uses: aio-app-dev

"Subscribe to product save events in Commerce"
→ AI uses: commerce-event-subscribe

"How do I handle Commerce webhooks?"
→ AI uses: search-commerce-docs

"Show me my current Adobe I/O workspace"
→ AI uses: aio-where

"Teach me about Commerce webhooks"
→ AI uses: search prompt

"Provide feedback about my experience"
→ AI uses: feedback prompt
```

### 备选案文2:直接工具命令

也可以直接使用斜线命令引用工具:

```bash
# Deploy your Adobe Commerce extension
/aio-app-deploy

# Start local development server
/aio-app-dev

# Invoke a runtime action locally
/aio-dev-invoke

# Search Commerce documentation
/search-commerce-docs "How to subscribe to Commerce events"

# Configure event providers
/onboard

# Deep search Commerce documentation
/search "How do webhooks work in Adobe Commerce?"

# Provide feedback about your experience
/feedback
```

### 代理文档搜索

这个 `search` 迅速在 Adobe Commerce 文档中进行迭接、交互式文件研究。 它用精细的查询进行多次搜索,取取链接页面以获取完整内容,并用代码示例和Doc链接提供结果. 当话题广泛时,它会提出澄清问题,让你选择要探索的领域.

**用法 :**

```
/search "How do webhooks work in Adobe Commerce?"
/search "storefront drop-in customization"
/search "event subscriptions and commerce events"
```

### 反馈收集

这个 `feedback` 即时帮助收集用户反馈以改善服务:

1.  **收集反馈**:AI会问你的经验,遇到的任何错误,面临的问题,或改进的建议
2.  **自动历史收藏**: 对话历史自动从当前聊天会话中收集
3.  **IMS 认证**: 使用您的 Adobe IMS 令牌( 从 `aio auth login`用于安全上传
4.  **本地备份**:聊天历史保存在本地 `chats/` 带有时间戳文件名的文件夹
5.  **服务器上传**:反馈和聊天历史都被上传到官方反馈服务

**认证**:反馈上传需要Adobe IMS认证. 确保你已经运行 `aio auth login` 在使用反馈特性之前.

**数据保密**:在上传前,敏感数据会自动从聊天历史中进行消毒. 以下各类敏感信息被删除或被替换为占位符: 1

-   **API 密钥、访问符和认证证书** ——改为: `[API_KEY]`, (中文(简体) ), `[TOKEN]`等 (中文(简体) ).
-   **密码、密钥和私钥** ——改为: `[PASSWORD]`, (中文(简体) ), `[SECRET]`等 (中文(简体) ).
-   **个人识别信息(PII)**:电子邮件地址、电话号码、地址、SSN + 替换为 `[EMAIL]`, (中文(简体) ), `[PHONE]`, (中文(简体) ), `[ADDRESS]`等 (中文(简体) ).
-   **信用卡号码和银行账户信息** ——改为: `[CREDIT_CARD]`, (中文(简体) ), `[ACCOUNT_NUMBER]`等 (中文(简体) ).
-   **内部IP地址、主机名或基础设施细节** ——改为: `[IP_ADDRESS]`, (中文(简体) ), `[HOSTNAME]`等 (中文(简体) ).
-   **任何其他机密或专有资料** + 替换为适当的占位符

**示例 - 卫生前后:**

**之前(原文聊天):**

```
[USER]
I'm having trouble with my API key: sk_live_51H8k2jK3mN9pQrS7tUvWxYz1234567890
Can you help me deploy my app? My email is john.doe@example.com
The server is at 192.168.1.100:8080

[ASSISTANT]
I can help you deploy. First, let's check your configuration.
```

**之后( 上传已禁用) :**

```
[USER]
I'm having trouble with my API key: [API_KEY]
Can you help me deploy my app? My email is [EMAIL]
The server is at [IP_ADDRESS]

[ASSISTANT]
I can help you deploy. First, let's check your configuration.
```

**数据隐私**:聊天历史在本地保存 `chats/` 带有基于时间戳的文件名的文件夹。 已消毒的版本被上传到反馈服务.

## \* 解决问题

### MCP 服务器未装入

**检查光标 MCP 设置 :**

1.  打开光标设置( Cmd+, 或 Ctrl+, )
2.  搜索“ MCP ”
3.  校验 `commerce-extensibility` 服务器已列出
4.  检查任何错误消息

**验证 mcp.json :**

```bash
# Check if file exists in your project
cat .cursor/mcp.json

# Verify the path is correct and absolute
ls -la /path/to/commerce-extensibility-tools/index.js
```

### 认证错误

文件搜索和反馈上传工具都需要 Adobe IMS 认证:

```bash
# Login to Adobe I/O (will open browser)
aio auth login

# Verify you're logged in
aio where
```

如果遇到认证错误( 401 未经授权) , 请尝试在 :

```bash
aio auth logout
aio auth login
```

### 高级配置

#### 以非生产环境为目标(仅限生产商)

默认情况下,文档搜索和反馈工具查询 **生产** 终点 环境从 `aio` CLI 设置 `cli.env`数字 :

| `aio config get cli.env` | 使用的终点 |
| --- | --- |
| `stage` | dev/阶段RAG |
| 未设定, `prod`,或任何东西 | 生产 |

要将工具指向dev/stage RAG,设置CLI环境并重新认证:

```bash
aio config set cli.env stage
aio auth login --force
```

要恢复生产:

```bash
aio config set cli.env prod
aio auth login --force
```

> ⚠️ **这个是给你的 _整个_ `aio` CLI环境,不只是这个MCP服务器.** 每一个 `aio` 命令和读取的工具 `cli.env` 现在将锁定目标阶段。 如果你准备好了 `stage` 并且忘记,文献搜索会默默地查询dev;反之,不设则意味着即使期待dev,你总是会点击prod. 当查询返回出乎意料的结果时, 请检查 `aio config get cli.env` 首先,环境不匹配是最常见的原因.

**说明**: 大多数用户应离开 `cli.env` 取消设置并使用默认的生产终点.

**警卫**:生产终点由Azure Front Door保护,使用:

-   Web 应用程序防火墙( WAF) 有 Microsoft 默认 规则Set 2.1 和 Bot 管理器 规则Set 1.0
-   美国禁运国家(古巴、伊朗、朝鲜、叙利亚、克里米亚、卢甘斯克、顿涅茨克)的地理封锁
-   边缘的 DDoS 保护
-   APIM 后端已锁定, 只接受来自前门的流量

### 未找到工具

如果光标找不到特定工具 :

1.  **完全重新启动光标** (退出并重新开放)
2.  **检查 MCP 服务器日志** 在 Cursor 开发者控制台中
3.  **验证安装**数字 :
    
    ```bash
    cd commerce-extensibility-tools
    npm install
    node index.js
    # Should start without errors
    ```
    

### 路径问题(窗口)

在视窗上,使用 **前斜线** 或者说 **逃脱后鞭打**数字 :

```json
// ✅ Good
"args": ["C:/Users/yourname/projects/commerce-extensibility-tools/index.js"]

// ✅ Also good
"args": ["C:\\Users\\yourname\\projects\\commerce-extensibility-tools\\index.js"]

// ❌ Bad
"args": ["C:\Users\yourname\projects\commerce-extensibility-tools\index.js"]
```

## 项目结构

```
commerce-extensibility-tools/
├── index.js                    # MCP server entry point
├── package.json                # Dependencies and configuration
├── README.md                   # This file
│
├── src/                        # MCP Server Implementation
│   ├── server.js               # MCP server core
│   ├── tools/                  # Tool implementations (11 tools)
│   │   ├── aio-app-deploy.js
│   │   ├── aio-app-dev.js
│   │   ├── aio-app-use.js
│   │   ├── aio-configure-global.js
│   │   ├── aio-dev-invoke.js
│   │   ├── aio-login.js
│   │   ├── aio-where.js
│   │   ├── onboard.js
│   │   ├── commerce-event-subscribe.js
│   │   ├── search-commerce-docs.js
│   │   └── upload-chat-history.js
│   ├── schemas/                # JSON schema definitions
│   ├── prompts/                # MCP prompt definitions and handlers
│   │   ├── index.js
│   │   ├── feedback.json
│   │   ├── search.json
│   │   └── handlers/
│   │       ├── feedback.js
│   │       └── search.js
│   └── utils/                  # Utility functions
│
├── dist/                       # Distributable Assets
│   └── integration-starter-kit/
│       ├── AGENTS.md           # Master orchestrator for AI agents
│       ├── skills/             # AI Agent Skills (7 skills)
│       │   ├── product-manager/SKILL.md
│       │   ├── architect/SKILL.md
│       │   ├── developer/SKILL.md
│       │   ├── tester/SKILL.md
│       │   ├── devops-engineer/SKILL.md
│       │   ├── technical-writer/SKILL.md
│       │   └── tutor/SKILL.md
│       ├── references/         # JSON schemas for architecture, requirements, etc.
│       └── examples/           # Example configurations and templates
│
└── rules/                      # AI Assistant Rules
    ├── Cursor/                 # Cursor IDE rules (19 files)
    │   ├── main-orchestrator.mdc
    │   ├── adobe-commerce-basics.mdc
    │   ├── app-builder-technical-guide.mdc
    │   └── ... (16 more)
    ├── Claude/                 # Claude AI rules
    ├── Copilot/                # GitHub Copilot rules
    └── Gemini/                 # Google Gemini rules
```

## 测试

使用 MCP 检查器测试 MCP 服务器 :

```bash
# Run the inspector
npm test

# Or manually
npx @modelcontextprotocol/inspector node index.js
```

检查员提供网络用户界面:

-   用自定义输入测试全部11个工具和2个提示
-   检查工具计划和说明
-   监视服务器日志和回复
-   除错连接问题

### 反馈上传问题

如果反馈上传失败 :

1.  **认证**:确保您已经运行 `aio auth login` - 反馈服务需要IMS认证
2.  **网络连接**:确保您可以上网,服务器端点可以到达
3.  **本地文件**: 检查 `chats/` 当前目录中的文件夹 - 即使上传失败, 聊天历史也总是保存在本地
4.  **限制费率**: 如果你看到429个错误, 请稍候, 再试一次
5.  **服务器响应**: 为服务器侧具体问题审查错误消息

## 页:1

-   [扩展名的 AI 编码工具](https://experienceleague.adobe.com/en/docs/commerce/cloud-service/migration/coding-tools) - 完整的设置和使用指南
-   [Adobe 开发者 App 构建器](https://developer.adobe.com/app-builder/docs/) - App 构建器文档
-   [Adobe 商务开发者](https://developer.adobe.com/commerce/) - 商业开发商资源
-   [示范背景协议](https://modelcontextprotocol.io/) - MCP规格
-   [光标 IDE](https://cursor.sh/docs) - 光标文档

## 安全隐私

-   **IMS 认证**: 文档搜索和反馈上传使用 Adobe IMS OAuth2 令牌
-   **无数据存储**: MCP 服务器不存储任何证书或数据
-   **本地执行**: 所有工具在您的机器上本地运行
-   **安全通讯**: 所有 API 调用都使用 HTTPS 并带有符号验证
-   **本地备份**:聊天历史在本地保存 `chats/` 上传前的文件夹

## ++ 辅助

关于议题和问题清单:

-   **Adobe I/O 语录**数字 : [Adobe 开发者文档](https://developer.adobe.com/app-builder/docs/)
-   **Adobe 商业**数字 : [Adobe 商务开发者文档](https://developer.adobe.com/commerce/)
-   **MCP 议定书**数字 : [示范背景协议](https://modelcontextprotocol.io/)
-   **光标 IDE**数字 : [光标文档](https://cursor.sh/docs)

## 捐款

这是一个分发存储器。 积极的开发发生在私人仓库中.

如需提出问题或建议,请洽Adobe Commerce扩展小组.

## 许可证

Adobe Commerce App Builder MCP 许可证条款. 见 [自由主义](https://npmcn.com/package/%40adobe-commerce/commerce-extensibility-tools/LICENSE) 详细情况。 使用须遵守Adobe企业许可证条款 [adobe.com/法律/术语/企业许可](https://www.adobe.com/legal/terms/enterprise-licensing.html)。 。 。 .

## 常见问题

### @adobe-commerce/commerce-extensibility-tools 是什么？

MCP 服务器为 AI 动力开发提供 Adobe Commerce 扩展工具

### 如何安装 @adobe-commerce/commerce-extensibility-tools？

在项目目录运行 npm install @adobe-commerce/commerce-extensibility-tools，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 commerce-extensibility-tools-mcp-server，可以用 npx commerce-extensibility-tools-mcp-server 直接运行。

### @adobe-commerce/commerce-extensibility-tools 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/adobe-commerce\_\_commerce-extensibility-tools 是否存在。

### @adobe-commerce/commerce-extensibility-tools 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @adobe-commerce/commerce-extensibility-tools 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @adobe-commerce/commerce-extensibility-tools 可以商用吗？

@adobe-commerce/commerce-extensibility-tools 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @adobe-commerce/commerce-extensibility-tools 的下载量有多少？

根据 npm 官方下载统计，@adobe-commerce/commerce-extensibility-tools 在 2026/10/05 – 2026/11/03 这 30 天内被下载 3,925 次，日均约 131 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @adobe-commerce/commerce-extensibility-tools 还在维护吗？

最新版本 3\.6\.0 发布于 2026/09/29（1 个月前）；至今共发布 26 个版本，其中过去 12 个月发布了 19 个；首次发布于 2025/08/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。