AI导哈

亚马逊SP API MCP服务器

一个模型上下文协议（MCP）服务器，提供对亚马逊销售伙伴API的无缝访问，使AI助手和应用程序能够检索产品信息、定价数据并生成亚马逊产品的列表优化建议。

  • by wilketob
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 wilketob/amztec-mcp-server

使用说明

Amazon SP API MCP服务器

模型上下文协议（MCP）服务器，提供对亚马逊销售合作伙伴API的无缝访问。该服务器使AI助手和应用程序能够检索产品信息、定价数据，并为亚马逊产品生成列表优化建议。

特性

  • 产品信息检索：按SKU获取全面的产品详细信息，包括标题、描述、功能、图像、属性、尺寸和销售排名
  • 定价数据访问：检索产品的当前竞争性定价信息
  • 列表优化：分析产品数据，为改进亚马逊商品列表提供结构化建议
  • 多用户支持：可针对不同的卖家账户和用户场景进行配置
  • 德国市场：为亚马逊德国（Marketplaces.DE）预配置

快速开始

先决条件

  • Python 3.10或更高版本
  • Amazon SP API凭据（刷新令牌、LWA应用程序凭据、AWS凭据、角色ARN）
  • 具有API访问权限的有效亚马逊卖家帐户

安装

  1. 克隆存储库：
git clone <repository-url>
cd amztec-mcp-server
  1. 使用uv安装依赖项（推荐）：
uv sync

或者使用pip：

pip install -r requirements.txt
  1. 设置环境变量：
cp .env.example .env

然后编辑 .env 使用您的Amazon SP API凭据：

AMAZON_REFRESH_TOKEN=your_refresh_token
AMAZON_LWA_APP_ID=your_lwa_app_id
AMAZON_LWA_CLIENT_SECRET=your_lwa_client_secret
AMAZON_AWS_ACCESS_KEY=your_aws_access_key
AMAZON_AWS_SECRET_KEY=your_aws_secret_key
AMAZON_ROLE_ARN=your_role_arn
SELLER_ID=your_seller_id

运行服务器

启动MCP服务器：

python amazon_mcp_server.py

测试Amazon SP API连接：

python test.py

MCP工具

服务器通过MCP接口公开了三个主要工具：

1.获取_亚马逊_产品_信息

按SKU检索全面的产品信息。

参数：

  • sku （必填）：产品的库存单位
  • seller_id （可选）：多用户场景的卖家ID

退货： 包含产品标题、描述、功能、图像、属性、尺寸和销售排名数据的JSON对象。

2.获取_亚马逊_产品_定价

获取产品的当前定价信息。

参数：

  • sku （必填）：产品的库存单位
  • seller_id （可选）：多用户场景的卖家ID

退货： JSON对象，包含来自亚马逊的有竞争力的定价数据。

3.优化产品列表

分析产品数据并提供优化建议。

参数：

  • asin （必填）：亚马逊标准识别号
  • optimization_focus （可选）：焦点区域-“标题”、“描述”、“功能”或“全部”
  • user_id （可选）：多用户场景的用户ID

退货： 用于外部分析和优化建议的结构化数据。

配置

Amazon SP API设置

  1. 注册成为Amazon SP API开发人员
  2. 使用Amazon（LWA）应用程序创建登录
  3. 设置具有必要权限的AWS IAM角色
  4. 通过授权工作流获取刷新令牌
  5. 在中配置环境变量 .env 文件

市场配置

默认情况下，服务器配置为德国市场。要更改市场，请修改 Marketplaces 参数在 AmazonSPAPIClient 初始化：

amazon_client = AmazonSPAPIClient(marketplace=Marketplaces.US)  # For US marketplace

建筑

  • 单文件MCP服务器：中包含的所有功能 amazon_mcp_server.py
  • AmazonSPAP客户端类：用于带有错误处理的Amazon SP API操作的包装器
  • MCP工具定义：AI助手集成的标准化接口
  • 异步支持：基于asyncio构建，可实现高效的并发操作

发展

项目结构

amztec-mcp-server/
�� amazon_mcp_server.py    # Main MCP server implementation
�� test.py                 # Test/debug script
�� hello.py               # Simple hello world script
�� pyproject.toml         # Project configuration
�� .env                   # Environment variables (not tracked)
�� README.md              # This file

依赖项

  • mcp[cli]>=1.9.3 -模型上下文协议框架
  • python-amazon-sp-api>=1.9.36 -Amazon SP API客户端库
  • python-dotenv>=1.1.0 -环境变量管理

测试

运行测试脚本以验证Amazon SP API连接：

python test.py

多用户支持

该服务器支持多用户场景，其中不同的用户可以拥有自己的Amazon SP API凭据。这对于管理多个卖家帐户的SaaS应用程序或服务非常有用。

错误处理

该服务器包括全面的错误处理功能，用于：

  • 无效或缺少凭据
  • 网络连接问题
  • 亚马逊API费率限制
  • 未找到产品场景
  • SKU/ASIN格式无效

许可证

[在此处添加您的许可证信息]

贡献

[在此处添加贡献指南]

支持

对于问题和疑问：

  • 查看Amazon SP API文档
  • 查看环境变量配置
  • 确保正确的API权限和速率限制

相关 MCP