返回 MCP 目录
public公开dns本地运行

AmazonSeller-mcp-server

亚马逊SP-API的MCP服务端,提供标准化接口和工具集

article

README

🚀 亚马逊销售伙伴API MCP服务器

本项目是一个用于与亚马逊销售伙伴 API 交互的模型上下文协议(MCP)服务器。它提供了一系列工具和资源,可通过标准化接口轻松访问亚马逊 SP - API 的各项功能,助力开发者高效开展业务。

🚀 快速开始

此服务器能协助你便捷地与亚马逊销售伙伴 API 进行交互。你可以借助它提供的工具和资源,通过标准化接口访问亚马逊 SP - API 的功能。

✨ 主要特性

  • 支持亚马逊 SP - API 的身份验证和授权,保障访问的安全性。
  • 全面覆盖 SP - API 端点,满足多样化的业务需求。
  • 提供丰富的 API 参考文档资源,方便开发者查阅。
  • 具备管理目录、库存、订单、报告等的实用工具。
  • 安全处理凭证,确保数据安全。

📦 安装指南

你可以选择以下两种方式进行安装:

npm install amazon-sp-api-mcp-server

或者直接运行:

npx amazon-sp-api-mcp-server

💻 使用示例

基础用法

启动服务器:

npm start

高级用法

开发时自动重启

npm run dev

使用 MCP Inspector 测试

npm run inspect

📚 详细文档

配置说明

在根目录创建一个 .env 文件,并添加你的亚马逊 SP - API 凭证:

SP_API_CLIENT_ID=your_client_id
SP_API_CLIENT_SECRET=your_client_secret
SP_API_REFRESH_TOKEN=your_refresh_token
SP_API_AWS_ACCESS_KEY=your_aws_access_key
SP_API_AWS_SECRET_KEY=your_aws_secret_key
SP_API_ROLE_ARN=your_role_arn
SP_API_MARKETPLACE_ID=ATVPDKIKX0DER
SP_API_REGION=us-east-1

可用工具

该服务器提供以下与亚马逊销售伙伴 API 交互的工具:

  • 认证工具
  • 目录管理
  • 库存管理
  • 订单处理
  • 报告生成和检索
  • 首料提交
  • 财务数据访问
  • 通知管理
  • 产品定价
  • 列表管理
  • FBA 操作

文档资源

通过 amazon-sp-api://{category} 资源访问 API 文档,类别包括:

  • overview
  • authentication
  • catalog
  • orders
  • inventory
  • reports
  • feeds
  • finance
  • notifications
  • productPricing
  • listings
  • fba

📄 许可证

本项目采用 MIT 许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端