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 客户端中。

📦 安装指南

配置文件路径

要将 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 服务器，只需指向 https://app.marketplaceadpros.com/mcp 这个 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

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

致谢

• 显然，要感谢 modelcontextprotocol 和 Anthropic 团队制定的 MCP 规范。https://modelcontextprotocol.io/introduction
• 感谢 MarketplaceAdPros 对本项目的支持和赞助。