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 支持並贊助此項目。