# @amazon-sp-api-release/sp-api-dev-mcp 中文文档

规范地址：https://npmcn.com/package/%40amazon-sp-api-release/sp-api-dev-mcp/

版本：1\.0\.5
npm 元数据更新时间：2026-08-18T16:07:09.243Z
中文译文更新时间：2026-11-06T05:15:44.431Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40amazon-sp-api-release/sp-api-dev-mcp
原文对照：https://npmcn.com/package/%40amazon-sp-api-release/sp-api-dev-mcp/?lang=original

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

- 包体积（解压后）：49.1 MB，82 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：3 个
- 首次发布：2026-05-12T10:04:15.497Z
- 最新版本发布：2026-08-18T16:07:09.083Z
- 近 30 天下载量：4926（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 6 个）

## 中文简介

捆绑多个 SP- API MCP 服务器的合并 npm 软件包

## 安装

```sh
npm install @amazon-sp-api-release/sp-api-dev-mcp
```

也可以使用：`pnpm add @amazon-sp-api-release/sp-api-dev-mcp`、`yarn add @amazon-sp-api-release/sp-api-dev-mcp`、`bun add @amazon-sp-api-release/sp-api-dev-mcp`

## README

# SP-API的当地MCP

> \[大  
> SP-API服务器的本地MCP是示范应用SP-API AI工具开发者集成工作流程的MCP实例.
> 
> 这些产品本身不是辅助产品,而是帮助我们的客户将我们的产品用于应用的教育范例。 作为我们的客户,任何你把这些实例纳入的应用程序,在投入生产或处理生产工作量之前,都应该根据你的企业的安全标准和政策进行彻底测试、保障和优化.

一个用于SP-API的本地MCP服务器,将多个开发者工具捆绑在一个npm包中. 安装一次,即可访问所有 SP-API 开发工具.

## 先决条件

-   **节点.js 20** 需要时间.

## 安装

```bash
npm install -g @amazon-sp-api-release/sp-api-dev-mcp
```

或者直接与 `npx` (不需要安装).

## 包含的服务器

### sp - api - dev - 助手- mcp - 服务器

拥有6个用于SP-API集成工具的开发者助理:

| 工具 | 说明 |
| --- | --- |
| `sp_api_reference` | 使用自然语言搜索官方 SP-API 文档 |
| `sp_api_explore_catalog` | 浏览 SP- API 端点目录( 参数、 方案、 实例) |
| `sp_api_execute` | 使用认证执行 SP- API 请求并签名 |
| `sp_api_generate_code_sample` | 生成代码样本( Python, Java, JavaScript, C#, PHP) |
| `sp_api_migration_assistant` | API版本之间的迁移(例如,命令v0到v2026-01-01) |
| `sp_api_optimize` | SP-API 整合代码的存档审查 |

大多数工具在当地工作,没有证书。 SP-API证书仅需用于 `sp_api_execute`。 。 。 .

### sp- api- 工作流程- mcp- 服务器

使用自然语言构建并执行 SP- API 工作流程 :

| 类别 | 工具 |
| --- | --- |
| **构建器** | `create_workflow`, (中文(简体) ), `import_workflow`, (中文(简体) ), `add_task_state`, (中文(简体) ), `add_fetch_state`, (中文(简体) ), `add_choice_state`, (中文(简体) ), `add_succeed_state`, (中文(简体) ), `add_fail_state`, (中文(简体) ), `add_wait_state`, (中文(简体) ), `add_pass_state`, (中文(简体) ), `add_input_state`, (中文(简体) ), `set_start_state`, (中文(简体) ), `get_workflow_schema`, (中文(简体) ), `validate_workflow`, (中文(简体) ), `list_workflows`, (中文(简体) ), `delete_workflow` |
| **口译** | `execute_workflow`, (中文(简体) ), `get_execution_status`, (中文(简体) ), `list_executions`, (中文(简体) ), `abort_execution`, (中文(简体) ), `get_execution_events`, (中文(简体) ), `resume_execution`, (中文(简体) ), `tail_execution_events` |
| **回电** | `list_pending_callbacks`, (中文(简体) ), `get_callback_details`, (中文(简体) ), `submit_callback`, (中文(简体) ), `extend_callback_timeout` |

SP-API的证书是制作活的API呼叫的工作流程所需的.

## MCP 客户端配置

### 克洛德桌面/ 基罗

添加到您的 MCP 配置文件 :

```json
{
  "mcpServers": {
    "sp-api-dev-assistant": {
      "command": "npx",
      "args": ["-y", "@amazon-sp-api-release/sp-api-dev-mcp", "sp-api-dev-assistant-mcp-server"],
      "env": {
        "SP_API_CLIENT_ID": "your-client-id",
        "SP_API_CLIENT_SECRET": "your-client-secret",
        "SP_API_REFRESH_TOKEN": "your-refresh-token"
      }
    },
    "sp-api-workflow": {
      "command": "npx",
      "args": ["-y", "@amazon-sp-api-release/sp-api-dev-mcp", "sp-api-workflow-mcp-server"],
      "env": {
        "SP_API_CLIENT_ID": "your-client-id",
        "SP_API_CLIENT_SECRET": "your-client-secret",
        "SP_API_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}
```

### 配置文件位置

| 客户端 | 配置文件 |
| --- | --- |
| 克劳德桌面( MacOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Claude 桌面 (Linux) Name | `~/.config/Claude/claude_desktop_config.json` |
| 光标 | `.cursor/mcp.json` 在您的项目中或 `~/.cursor/mcp.json` 全球 |
| VS 代码( MCP 扩展) | `.vscode/mcp.json` 在您的项目中 |
| 基罗 | `.kiro/settings/mcp.json` 在您的项目中 |

## 环境变量

| 变量 | 所需时间 | 说明 |
| --- | --- | --- |
| `SP_API_CLIENT_ID` | `sp_api_execute`,工作流程执行 | SP- API OAuth 客户端标识 |
| `SP_API_CLIENT_SECRET` | `sp_api_execute`,工作流程执行 | SP- API OAuth 客户端秘密 |
| `SP_API_REFRESH_TOKEN` | `sp_api_execute`,工作流程执行 | SP- API 刷新令牌 |
| `SP_API_BASE_URL` | 可选 | 覆盖 SP- API 基础 URL( 默认: NA 端点) |
| `SP_API_REGION` | 可选 | 销售区域: `na`, (中文(简体) ), `eu`, (中文(简体) ), `fe` (默认 : `na`(中文(简体) ) |
| `LOG_LEVEL` | 可选 | 日志级别 : `error`, (中文(简体) ), `warn`, (中文(简体) ), `info`, (中文(简体) ), `debug` |

## 许可证

阿帕奇 - 2.0

## 常见问题

### @amazon-sp-api-release/sp-api-dev-mcp 是什么？

捆绑多个 SP- API MCP 服务器的合并 npm 软件包

### 如何安装 @amazon-sp-api-release/sp-api-dev-mcp？

在项目目录运行 npm install @amazon-sp-api-release/sp-api-dev-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 sp-api-dev-mcp、sp-api-dev-assistant-mcp-server、sp-api-workflow-mcp-server，可以用 npx sp-api-dev-mcp 直接运行。

### @amazon-sp-api-release/sp-api-dev-mcp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @amazon-sp-api-release/sp-api-dev-mcp 支持 ESM 还是 CommonJS？

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

### @amazon-sp-api-release/sp-api-dev-mcp 需要什么版本的 Node\.js？

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

### @amazon-sp-api-release/sp-api-dev-mcp 可以商用吗？

@amazon-sp-api-release/sp-api-dev-mcp 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @amazon-sp-api-release/sp-api-dev-mcp 的下载量有多少？

根据 npm 官方下载统计，@amazon-sp-api-release/sp-api-dev-mcp 在 2026/10/06 – 2026/11/04 这 30 天内被下载 4,926 次，日均约 164 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @amazon-sp-api-release/sp-api-dev-mcp 还在维护吗？

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