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 
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权限和速率限制