mcpField
A
amazon-ads-mcp-server

amazon-ads-mcp-server

本地服务
github.com/MarketplaceAdPros云与基础设施296 天前更新

关于 amazon-ads-mcp-server

amazon-ads-mcp-server 是一个 MCP 服务,用于通过 MarketplaceAdPros 连接 Amazon Advertising 数据。它面向需要查询广告数据的用户,可访问 Sponsored Products、Sponsored Brands 和 Sponsored Display 的广告资源与报告。

主要功能

  1. 01访问 Sponsored Products、Sponsored Brands 与 Sponsored Display 资源
  2. 02支持使用自然语言查询报告
  3. 03提供 MarketplaceAdPros 推荐与实验功能(需订阅)
  4. 04支持 npx 运行、本地构建及 Streamable HTTP 远程连接

适用场景

  1. 01查询广告活动、广告组、关键词和投放设置
  2. 02通过自然语言分析广告报告数据
  3. 03在 Claude Desktop 等客户端中管理 Amazon 广告资源

MCP 相关

该项目是 MCP 服务,向 MCP 客户端提供 Amazon 广告相关资源与报告查询能力,并可通过 Streamable HTTP 端点远程访问。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"amazon-ads": {
"command": "npx",
"args": [
"-y",
"@marketplaceadpros/amazon-ads-mcp-server"
],
"env": {
"BEARER_TOKEN": "<BEARER_TOKEN>"
}
}
}
}
启动命令npx -y @marketplaceadpros/amazon-ads-mcp-server
需要配置的环境变量
BEARER_TOKEN密钥

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@marketplaceadpros/amazon-ads-mcp-server

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

amazon-ads-mcp-server

通过将您的账户与 MarketplaceAdPros 集成,连接到您的 Amazon 广告数据。

提供以下访问权限:

  • Sponsored Products、Sponsored Brands 和 Sponsored Display 中的广告资源,例如 Campaign、Ad Group、Keyword、Product Ad 和 Targeting
  • 报告,以及使用通俗英语查询报告的能力。
  • 通过已购买的订阅计划访问 Marketplace Ad Pros 的建议、实验等内容

连接到 https://app.marketplaceadpros.com/mcp,也可将其用作 Streamable 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 获取的 Bearer token
配置

您可以在 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"
      }
    }
  }
}

或者,如果您的客户端支持 Streamable HTTP MCP 服务,只需将其指向 MCP 端点 https://app.marketplaceadpros.com/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 服务通过 stdio 通信,调试可能颇具挑战。我们推荐使用 MCP Inspector,它可作为包脚本使用:

npm run inspector

amazon-ads-mcp-server 在 inspector 中运行

Inspector 会提供一个 URL,供您在浏览器中访问调试工具。

致谢

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。