Amazon Orders

amazon-orders-mcp 是一款非官方的 MCP 服务，用于获取 Amazon 订单历史、订单项 和交易记录，基于 amazon-orders 构建。它为你的 AI 助手提供 Amazon 账户工具，可通过 Claude 和任何其他 MCP 客户端使用。

该服务不会接触你的凭据。登录时，浏览器窗口会打开 Amazon 官方页面，服务会复用登录后留下的会话。它也能在无显示器的服务器上运行，你可以通过终端登录（参见远程客户端）。

注意： 该服务通过 amazon-orders 读取数据，而 amazon-orders 的工作方式是解析 Amazon 面向消费者的网站数据。由于 Amazon 没有提供可用的官方 API，旧版本可能随时失效，因此建议使用最新版本。

安装

amazon-orders-mcp 可从 PyPI 获取，并通过 uvx 运行，因此无需预先安装。将其添加到你的 AI 助手中：

Claude

Claude Desktop： 从 最新版本下载 amazon-orders-mcp-<version>.mcpb 并打开。

Claude Code：

claude mcp add amazon-orders -- uvx amazon-orders-mcp

ChatGPT

ChatGPT Desktop： 在“设置”→“插件”中，添加一个 STDIO 类型的 MCP 服务，并将 uvx 设为命令、 amazon-orders-mcp 设为参数。

Codex：

codex mcp add amazon-orders -- uvx amazon-orders-mcp

其他客户端

任何可运行本地 MCP 服务的客户端都可以使用此 JSON；如果你已通过 pip install amazon-orders-mcp 安装， 也可以将 amazon-orders-mcp 用作命令：

{
  "mcpServers": {
    "amazon-orders": {
      "command": "uvx",
      "args": ["amazon-orders-mcp"]
    }
  }
}

远程客户端

对于连接到服务而不是运行服务的客户端，该服务也可以提供 Streamable HTTP：

uvx amazon-orders-mcp --transport streamable-http

监听地址为 http://127.0.0.1:8000/mcp。使用 --help 可更改监听地址，或要求使用 bearer token（非回环地址时必需）。在无显示器的服务器上，sign_in 无法打开浏览器窗口，因此请先在服务器上使用 uvx amazon-orders login 登录；该命令会要求输入用户名和密码。

Docker

docker build -t amazon-orders-mcp .
docker run -i --rm -v amazon-orders:/home/app/.config/amazonorders amazon-orders-mcp

容器没有显示器，因此请先使用 login target 登录。具体方式请参阅 Dockerfile。

基本用法

只需向助手询问你的订单，它就会使用以下工具：

工具	返回内容
sign_in	按需打开浏览器窗口，让你登录 Amazon
get_orders	按年份、时间筛选条件或订单类型批量获取订单，也可选择获取详细信息
search_orders	按商品、订单号、地址或收件人搜索任意年份的商品，并批量返回
get_order	按订单号获取一个订单
get_tracking	根据订单的货件 ID 获取承运商和追踪编号
get_invoices	获取订单的可打印摘要，以及卖家提供的任何发票 PDF
get_family_members	获取可查看其订单的 Amazon Household 成员，例如青少年账户
get_transactions	按天数范围或订单批量获取付款交易记录
get_gift_cards	获取礼品卡余额，以及指定天数范围内的活动记录
get_prime_payments	获取 Prime 会员费扣款及各自的订单号
check_session	检查你是否已登录，以及你在哪些 Amazon 网站有会话
get_config	获取助手可以更改的设置及其值
update_config	更改其中一项设置

订单历史记录和交易记录会按批次返回 limit 条结果（默认 25 条，每批最多可多请求一页），并附带一个 cursor，供助手传回以获取下一批结果。

每个读取 Amazon 数据的工具都接受可选的 site 参数，例如 amazon.de，这样助手就能通过一个服务读取你购物过的各个 Amazon 网站上的数据，例如“我最近的 amazon.de 订单”。如果不指定，工具会读取你的默认网站，即 domain 设置指定的网站。每个网站都需要单独登录，因此请让助手分别为你登录每个网站。

配置

让助手更改设置，例如默认 Amazon 网站（如 amazon.co.uk）或用于登录的浏览器。这些设置与 amazon-orders CLI 共享，因此会同步应用相同的更改。请参阅支持的网站，了解 amazon-orders 可以读取哪些网站。

文档

如需了解服务返回的数据，amazon-orders 的官方文档请见 Read the Docs，其中包括 Order 实体的字段和故障排除。

贡献

想要提供资金支持吗？如果你觉得 amazon-orders-mcp 有用，非常欢迎通过赞助的方式支持我们！