AI导哈

亚马逊订单查询服务

一个基于MCP协议的亚马逊订单查询服务，允许AI助手查询亚马逊订单历史。

  • by muness
  • Python
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 muness/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

致谢

这个项目是一个围绕优秀MCP的薄包装 亚马逊订单 图书馆by 亚历克斯·莱尔德。与亚马逊进行身份验证和解析订单数据的所有繁重工作都是由该库完成的。非常感谢。

许可证

麻省理工学院

相关 MCP