mcp-amazon

@codespar/mcp-amazon

适用于 Amazon Selling Partner API（SP-API）的 MCP 服务，覆盖全球最大的电商平台，包括 Amazon BR、Amazon MX、Amazon US 以及所有欧盟和远东市场。

对于拉美卖家，Amazon 补全了此目录中已有的三大电商平台：

• Mercado Libre（@codespar/mcp-mercadolibre）——在拉美整体占据主导地位（BR、AR、MX、CO、CL）。
• Shopee（@codespar/mcp-shopee）——在巴西势头强劲，并在该地区迅速发展。
• Amazon（本软件包）——覆盖全球，同时为拉美卖家提供 Amazon BR/MX，并支持跨境进入 Amazon US/EU/JP。

这三者几乎覆盖了拉美商家开展有意义 GMV 交易的所有电商平台。

工具（24）

工具	用途
list_orders	列出 Amazon SP-API 中的订单。
get_order	根据 AmazonOrderId 获取单个订单（例如
get_order_items	根据 AmazonOrderId 获取订单的商品明细。
get_listings_item	根据 SKU 获取卖家的单个商品刊登信息。
put_listings_item	根据 SKU 为卖家创建或完全替换商品刊登信息。
delete_listings_item	根据 SKU 删除卖家的商品刊登信息。
search_catalog_items	按标识符或关键词搜索 Amazon 商品目录，查找参考商品数据（ASIN、标题、品牌、图片）。
get_inventory_summary	获取 FBA 库存摘要（可配送、入库、预留、调查中和不可配送的数量），用于...
create_report	请求 SP-API 报告。
get_report	获取报告状态；报告完成（DONE）后，还会返回其 reportDocumentId，随后可从 Reports 文档...
list_financial_events	列出用于对账的财务事件（发货、退款、服务费、调整等）。
get_order_shipment_status	通过 Shipping API（Amazon Shipping / Buy Shipping 标签）获取指定货件 ID 的发货状态。
create_subscription	为指定的 notificationType 创建 Notifications API 订阅（相当于 SP-API 事件的 webhook，...
patch_listings_item	使用 JSON Patch 操作列表，按 SKU 部分更新卖家的商品刊登信息。
confirm_shipment	确认订单商品已发货（Orders API v0）。
update_shipment_status	更新订单的发货状态（Orders API v0）。
list_reports	列出卖家已请求的报告。
cancel_report	取消处于 IN_QUEUE 且尚未开始处理的报告。
create_feed	向 SP-API 提交数据源（例如
get_feed	获取数据源状态；数据源完成（DONE）后，还会返回其 resultFeedDocumentId，可从 Feed Document API... 获取结果。
list_financial_events_by_order	列出指定单个订单的财务事件（发货、退款、服务费、调整）。
get_my_fees_estimate_for_asin	估算以指定价格销售某个 ASIN 的推荐费和 FBA 费用。
list_subscriptions	获取指定 notificationType 的当前订阅（每个应用的每种 notificationType 只能有一个订阅）。
get_marketplace_participations	列出卖家已注册销售的所有电商平台（Sellers API）。

安装

npm install @codespar/mcp-amazon@alpha

环境

AMAZON_LWA_CLIENT_ID="amzn1.application-oa2-client....."
AMAZON_LWA_CLIENT_SECRET="..."
AMAZON_REFRESH_TOKEN="Atzr|..."          # long-lived, seller-authorized
AMAZON_MARKETPLACE_ID="A2Q3Y263D00KWC"   # BR; ATVPDKIKX0DER=US, A1AM78C64UM0Y8=MX
AMAZON_REGION="na"                        # na | eu | fe (default na)
AMAZON_SELLER_ID="A3..."                  # optional; default for Listings tools

常见电商平台 ID

电商平台	ID	区域
巴西	A2Q3Y263D00KWC	na
美国	ATVPDKIKX0DER	na
墨西哥	A1AM78C64UM0Y8	na
加拿大	A2EUQ1WTGCTBG2	na
西班牙	A1RKKUPIHCS9HS	eu
英国	A1F83G8C2ARO7P	eu
德国	A1PA6795UKMFR9	eu
日本	A1VC38T7YXB528	fe

身份验证

SP-API 使用两步式 Login with Amazon（LWA）流程：

1. 交换刷新令牌 → 访问令牌（有效期为 1 小时）。服务端向 https://api.amazon.com/auth/o2/token 发送 POST 请求，并提供 grant_type=refresh_token 以及你的 client_id / client_secret / refresh_token。结果会缓存在内存中，直到过期前约 1 分钟。
2. 调用 SP-API，使用区域基础 URL 和请求头 x-amz-access-token: <token> 以及 Content-Type: application/json。

AWS Signature v4 请求签名过去是 SP-API 的必要要求。Amazon 于 2023 年取消了大多数租户的 SigV4 要求，因此此服务仅使用 LWA 身份验证。如果你的卖家账号仍被标记为需要 SigV4，则需要为 amazonRequest 封装一个签名器（@aws-sdk/signature-v4）——此处未包含该签名器。

区域基础 URL

• NA（美洲，包括 BR/US/MX/CA）：https://sellingpartnerapi-na.amazon.com
• EU（欧洲 + 印度 + MENA）：https://sellingpartnerapi-eu.amazon.com
• FE（远东——日本、澳大利亚、新加坡）：https://sellingpartnerapi-fe.amazon.com

使用 AMAZON_REGION 进行选择。巴西和美洲使用 na。

运行

# stdio (default — Claude Desktop, Cursor, etc)
npx @codespar/mcp-amazon

# HTTP (server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-amazon

通知

对于 SP-API，create_subscription 相当于 Webhook。Amazon 不会直接推送 HTTP Webhook——你需要先通过 POST /notifications/v1/destinations 创建一个目标（SQS 队列或 EventBridge 总线），然后将订阅关联到该目标。此软件包支持创建订阅；目标配置通常只需设置一次，可通过 AWS Console 或部署脚本完成。

状态

0.1.0-alpha.1 — SP-API 包含 30 多个商品相关部分，此软件包涵盖其中与商业相关的子集（订单、商品信息、目录、库存、报告、财务、配送、通知）。端点路径和身份验证流程均按已发布的规范实现；正式使用前，应使用真实卖家令牌对工具契约进行集成测试。LWA 刷新流程以及 x-amz-access-token 请求头的用法已根据当前 SP-API 文档确认。

企业版

需要为 Agent 付款提供治理、预算限制和审计追踪？CodeSpar Enterprise 在这些 MCP 服务的基础上增加了策略引擎、支付路由和合规模板。

许可证

MIT