🚀 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 启用并赞助了这个项目。