SP-API的当地MCP
[大
SP-API服务器的本地MCP是示范应用SP-API AI工具开发者集成工作流程的MCP实例.这些产品本身不是辅助产品,而是帮助我们的客户将我们的产品用于应用的教育范例。 作为我们的客户,任何你把这些实例纳入的应用程序,在投入生产或处理生产工作量之前,都应该根据你的企业的安全标准和政策进行彻底测试、保障和优化.
一个用于SP-API的本地MCP服务器,将多个开发者工具捆绑在一个npm包中. 安装一次,即可访问所有 SP-API 开发工具.
先决条件
- 节点.js 20 需要时间.
安装
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 配置文件 :
{
"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