亚马逊购物MCP服务器\[正在进行中\]
⚠️ 重要：该软件包目前正在开发中，尚未准备好投入生产使用。当前版本正在开发中，可能包含不完整的功能或破坏性更改。
一个模型上下文协议（MCP）服务器，允许您通过Claude或任何其他MCP客户端搜索亚马逊产品、查看详细信息、将商品添加到购物车和结账。
特性
- 🔍 产品搜索：使用关键字和类别过滤搜索亚马逊庞大的目录
- 📋 产品详情：获取有关使用其ASIN的任何产品的全面详细信息
- 🛒 购物车管理：创建购物车、添加商品和查看购物车内容
- 💳 结账：通过亚马逊官方结账完成购买
先决条件
- （v16或更高版本）
- 亚马逊产品广告API访问权限（需要亚马逊助理帐户）
- Amazon API凭据的环境变量
安装
- 克隆此存储库或下载源代码：
git clone https://github.com/yourusername/amazon-shopping-mcp.git
cd amazon-shopping-mcp- 安装依赖项：
npm install- 创建一个
.env使用您的亚马逊产品广告API凭证提交文件：
cp .env.example .env编辑 .env 文件以包含您的Amazon API凭据：
AWS_ACCESS_KEY_ID=your_access_key
AWS_SECRET_ACCESS_KEY=your_secret_key
AWS_ASSOCIATE_TAG=your_associate_tag
AWS_REGION=US- 构建服务器：
npm run build使用Claude for Desktop
- 通过将Claude for Desktop添加到您的
claude_desktop_config.json文件：
{
"mcpServers": {
"amazon-shopping": {
"command": "node",
"args": ["/absolute/path/to/amazon-shopping-mcp/build/src/index.js"],
"env": {
"AWS_ACCESS_KEY_ID": "your_access_key",
"AWS_SECRET_ACCESS_KEY": "your_secret_key",
"AWS_ASSOCIATE_TAG": "your_associate_tag",
"AWS_REGION": "US"
}
}
}
}- 重新启动Claude for Desktop，您将看到“亚马逊购物”MCP服务器已连接。
可用的MCP工具
产品工具
- 搜索产品：在亚马逊上搜索产品
- 参数： - keywords：搜索词（必填） - category：产品类别（可选，默认：“全部”） - sortBy：排序顺序（可选，默认：“relevancerak”） - page：结果页码（可选，默认值：1）
- 获取产品详细信息：获取产品的详细信息
- 参数： - asin：亚马逊标准标识号（必填）
购物车工具
- 创建购物车：使用商品创建新的购物车
- 参数： - asin：产品ASIN（必填） - quantity：要添加的数量（可选，默认值：1）
- 加入购物车：将商品添加到现有购物车
- 参数： - asin：产品ASIN（必填） - quantity：要添加的数量（可选，默认值：1）
- 查看购物车：查看您当前的购物车内容
- 无需参数
- 结账：获取链接以在亚马逊上完成购买
- 无需参数
对话示例
以下是一个如何将MCP服务器与Claude一起使用的示例：
You: Can you find me some wireless headphones on Amazon?
Claude: I'll search for wireless headphones on Amazon for you.
[Uses search-products tool with keywords="wireless headphones"]
You: Show me more details about the second one in the list.
Claude: Here are the details for those headphones.
[Uses get-product-details tool with the ASIN]
You: Add those to my cart please.
Claude: I've added the headphones to your cart.
[Uses create-cart or add-to-cart tool]
You: What's in my cart now?
Claude: Here's what's currently in your cart.
[Uses view-cart tool]
You: I'd like to check out now.
Claude: Here's a link to complete your purchase on Amazon.
[Uses checkout tool and provides the checkout URL]局限性
- 亚马逊产品广告API有费率限制（通常每秒1个请求）
- Kindle电子书和MP3等数字产品不能通过API添加到购物车中
- 您必须在亚马逊网站上完成实际购买
- 此服务器需要Amazon Associates凭据，因此您必须是Amazon Associates计划的一部分
获取亚马逊产品广告API访问权限
- 注册 亚马逊联盟项目
- 一旦被批准为助理，请登录您的亚马逊助理帐户
- 转到“工具”并选择“产品广告API”
- 点击“加入”注册API
- 注册后，下载您的凭据或复制您的访问密钥和密钥
许可证
麻省理工学院