Amazon Order MCP

亚马逊订购MCP服务器

MCP（模型上下文协议）服务器，用于封装 亚马逊订单 Python库，允许AI助手查询亚马逊订单历史。

安装

git clone https://github.com/muness/amazon-order-mcp.git
cd amazon-order-mcp
pip install -e .

或者直接安装依赖项：

pip install "mcp[cli]>=1.2.0" "amazon-orders>=4.0.0" "python-dotenv>=1.0.0" "nest-asyncio>=1.6.0"

配置

将您的亚马逊凭据设置为环境变量：

export AMAZON_USERNAME="your-amazon-email@example.com"
export AMAZON_PASSWORD="your-amazon-password"

或者创建一个 .env 项目目录中的文件。

克劳德代码/克劳德桌面配置

添加到MCP配置(.mcp.json 或 claude_desktop_config.json):

{
  "mcpServers": {
    "amazon-orders": {
      "command": "python",
      "args": ["/path/to/amazon-order-mcp/amazon_order_mcp.py"],
      "env": {
        "AMAZON_USERNAME": "your-amazon-email@example.com",
        "AMAZON_PASSWORD": "your-amazon-password"
      }
    }
  }
}

可用工具

amazon_login

先叫这个！ 通过亚马逊进行身份验证。在使用其他工具之前需要。

参数：

• otp_code （可选）：您的验证器应用程序中的6位2FA代码。如果启用2FA，则为必填项。
• debug （可选）：启用调试输出。

示例流程：

1. 呼叫 amazon_login()
2. 如果启用2FA，它将返回 OTP_REQUIRED
3. 询问用户当前的OTP代码
4. 呼叫 amazon_login(otp_code="123456")

amazon_get_order_history

获取特定时间段的订单历史记录。

参数：

• year （可选）：特定年份（例如2024年）。默认为当前年份。
• time_filter （可选）：使用而不是年份- "last30" 在过去的30天里， "months-3" 在过去的3个月里。
• full_details （可选）：如果为true，则获取包括商品在内的完整订单详细信息（速度较慢）。

amazon_get_order

获取特定订单的详细信息。

参数：

• order_id （必填）：亚马逊订单号（例如。， "111-1234567-1234567").

amazon_search_orders

按商品标题搜索订单。

参数：

• search_term （必填）：在项目标题中搜索的文本。
• year （可选）：搜索年份。
• time_filter （可选）：时间过滤器，而不是年份。

重要说明

• 没有官方API：此库会抓取亚马逊的网站，如果亚马逊更改其网站结构，则可能会损坏。
• 仅限English.com：仅支持英文版Amazon.com网站。
• 需要2FA：大多数亚马逊帐户都启用了2FA。这 amazon_login 该工具可以处理此问题——只需在提示时提供OTP代码。
• 速率限制：请注意您查询的频率——亚马逊可能会对可疑活动进行评分限制或标记。

发展

# Run the server directly
python amazon_order_mcp.py

# Or via the installed script
amazon-order-mcp

致谢

许可证

麻省理工学院