amazon-sp-mcp

概述

此 MCP 服务器通过 SP-API 实现 Amazon 卖家中心的自然语言交互。它提供全面的订单信息、库存管理、销售指标、财务报告和分析数据访问。实现仅使用 LWA OAuth 2.0 认证，无需 AWS 凭据。服务器包含强大的速率限制、全面的错误处理，并支持北美、欧洲和远东地区的多个 Amazon 市场。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• get_orders

  List orders by date range, status, fulfillment channel

  试试:Get my orders from last week试试:Show me pending FBA orders
• get_order_details

  Get details for a specific order

  试试:Show me details for order 123-4567890试试:What items are in order 902-9876543
• get_order_items

  Get line items for an order

  试试:List items in order 123-4567890试试:What products were in my latest order
• get_inventory_summary

  FBA inventory levels and health

  试试:What's my current inventory status试试:Show me my FBA inventory levels
• get_fba_inventory_details

  Detailed breakdown of reserved/unfulfillable quantities

  试试:Show me detailed inventory health试试:Which SKUs are unfulfillable
• get_sales_metrics

  Sales aggregates by day/week/month

  试试:What were my sales last month试试:Show weekly sales averages
• get_fba_reimbursements

  Lost/damaged inventory reimbursements

  试试:Show me FBA reimbursements for January试试:What reimbursements do I have for lost items
• get_settlement_report

  Payment disbursement details

  试试:Pull my settlement report试试:Show me last payment breakdown
• get_fba_fee_estimates

  Per-SKU fee breakdown

  试试:What are my FBA fees by SKU试试:Show fee estimates for my inventory
• get_storage_fees

  Monthly storage charges

  试试:What are my storage fees this month试试:Show me storage charges by SKU
• get_longterm_storage_fees

  LTSF for aged inventory (365+ days)

  试试:Show my long-term storage fees试试:Which items have been in storage over a year
• get_sales_traffic_report

  Sessions, page views, conversion rates

  试试:Show me my sales traffic metrics试试:What's my conversion rate for last month

可对比工具

安装

# 克隆并安装
git clone https://github.com/mansournorouzi/amazon-sp-mcp.git
cd amazon-sp-mcp
npm install
npm run build

# 配置凭据
cp .env.example .env
# 编辑 .env 文件，添加您的 LWA 凭据、卖家 ID 和市场 ID

# 对于 Claude Desktop
添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：
```json
{
  "mcpServers": {
    "amazon-seller": {
      "command": "node",
      "args": ["/path/to/amazon-sp-mcp/build/index.js"],
      "env": {
        "LWA_CLIENT_ID": "amzn1.application-oa2-client.xxxxx",
        "LWA_CLIENT_SECRET": "your_secret",
        "LWA_REFRESH_TOKEN": "Atzr|your_token",
        "SELLER_ID": "your_seller_id",
        "MARKETPLACE_ID": "ATVPDKIKX0DER",
        "SP_API_ENDPOINT": "https://sellingpartnerapi-na.amazon.com"
      }
    }
  }
}

FAQ

此服务器使用什么认证方法？

服务器仅使用 LWA (Login with Amazon) OAuth 2.0 认证，不需要 AWS 凭据或 IAM 设置。

支持哪些 Amazon 市场？

服务器支持所有主要 Amazon 市场，包括北美、欧洲和远东地区，每个区域都有可配置的端点。

amazon-sp-mcp 对比