amazon-ads-mcp-server

🚀 amazon-ads-mcp-server

通过将您的账户与 MarketplaceAdPros 集成，连接到您的亚马逊广告数据。本项目提供以下访问权限：

• 赞助商品、赞助品牌和赞助展示中的广告资源，如广告活动、广告组、关键词、商品广告、定位等。
• 报告以及使用自然语言查询报告的功能。
• 购买订阅计划后可使用 Marketplace Ad Pros 的推荐、实验等功能。

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

🚀 快速开始

本项目可帮助您连接到亚马逊广告数据，通过与 MarketplaceAdPros 集成，您可以方便地访问各类广告资源和报告等。

📦 安装指南

要将 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 获取的 Bearer 令牌

配置

您可以通过以下几种方式进行配置：

通过 npx 在 Claude Desktop 中配置

{
  "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 服务器时的配置

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

在 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，您可以在浏览器中访问调试工具。

🔧 技术细节

本项目依赖于 MCP 规范，通过与 MarketplaceAdPros 集成，为用户提供对亚马逊广告数据的访问。它支持多种配置方式，方便用户根据自己的需求进行使用。同时，通过标准输入输出进行通信，需要使用特定的调试工具进行调试。

📄 许可证

文档中未提及许可证相关信息。

致谢

• 显然，感谢 modelcontextprotocol 和 Anthropic 团队制定的 MCP 规范。https://modelcontextprotocol.io/introduction
• 感谢 MarketplaceAdPros 启用并赞助了这个项目。