Amazon Ads MCP Server

🚀 amazon-ads-mcp-server

amazon-ads-mcp-server 可让你将账户与 MarketplaceAdPros 集成，从而连接到你的亚马逊广告数据。该项目为你提供以下功能：

• 访问赞助商品、赞助品牌和赞助展示中的广告资源，如广告活动、广告组、关键词、商品广告、定位等。
• 提供报告，并支持使用自然语言查询这些报告。
• 若购买了订阅计划，还可使用 Marketplace Ad Pros 提供的推荐、实验等功能。

此外，你还可以通过连接到 https://app.marketplaceadpros.com/mcp，将其作为可流式传输的 HTTP MCP 服务器使用。

🚀 快速开始

你可以根据自身需求，将 amazon-ads-mcp-server 添加到你选择的 MCP 客户端中。

📦 安装指南

服务器配置文件路径

• MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

环境变量

• BEARER_TOKEN：你从 MarketplaceAdPros.com 获取的令牌。

配置方式

使用 npx 配置

在你的 Claude Desktop 配置中，可按如下方式使用 npx：

{
  "mcpServers": {
    "marketplaceadpros": {
      "command": "npx",
      "args": [
        "@marketplaceadpros/amazon-ads-mcp-server"
      ],
      "env": {
        "BEARER_TOKEN": "abcdefghijklmnop"
      }
    }
  }
}

克隆仓库后配置

若你克隆了仓库，可以进行构建并在 Claude Desktop 配置中使用，示例如下：

{
  "mcpServers": {
    "marketplaceadpros": {
      "command": "node",
      "args": [
        "/path/to/amazon-ads-mcp-server/build/index.js"
      ],
      "env": {
        "BEARER_TOKEN": "abcdefghijklmnop"
      }
    }
  }
}

支持流式 HTTP MCP 服务器的客户端配置

若你的客户端支持流式 HTTP MCP 服务器，可直接指向 MCP 端点 https://app.marketplaceadpros.com/mcp，示例如下：

{
  "mcpServers": {
    "marketplaceadpros": {
      "type": "streamable-http",
      "url": "https://app.marketplaceadpros.com/mcp"
    }
  }
}

在 LibreChat 中配置

在 LibreChat 中的配置示例如下：

  MAP:
    type: streamable-http
    url: https://app.marketplaceadpros.com/mcp
    headers:
      Authorization: "Bearer abcdefghijklmnop"

💻 使用示例

开发环境依赖安装

npm install

构建服务器

npm run build

开发环境自动重建

npm run watch

调试

由于 MCP 服务器通过标准输入输出进行通信，调试可能具有一定挑战性。我们建议使用 MCP Inspector，它可作为一个包脚本使用：

npm run inspector

Inspector 会提供一个 URL，你可以在浏览器中访问调试工具。

致谢

• 感谢 modelcontextprotocol 和 Anthropic 团队制定 MCP 规范：https://modelcontextprotocol.io/introduction
• 感谢 MarketplaceAdPros 支持并赞助此项目。