amazon-ads-mcp-server

amazon-ads-mcp-server

アカウントをMarketplaceAdProsと連携して、Amazon Advertising Dataに接続します。

以下にアクセスできます。

• Sponsored Products、Sponsored Brands、Sponsored Displayの広告リソース（キャンペーン、広告グループ、キーワード、商品広告、ターゲティングなど）
• レポートと、平易な英語でレポートを照会する機能
• 購入済みのサブスクリプションプランで利用できるMarketplace Ad Prosのレコメンデーション、実験など

https://app.marketplaceadpros.com/mcpに接続して、Streamable HTTP MCP サーバーとしても利用できます。

インストール

お使いのMCPクライアントにamazon-ads-mcp-serverを追加するには、サーバー設定に次の内容を追加します。

MacOSの場合：~/Library/Application Support/Claude/claude_desktop_config.json

Windowsの場合：%APPDATA%/Claude/claude_desktop_config.json

環境変数

• BEARER_TOKEN：MarketplaceAdPros.comから取得したBearerトークン

設定

次のように、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

Inspectorから、ブラウザーでデバッグツールにアクセスするためのURLが提供されます。

謝辞

• もちろん、MCP仕様を策定したmodelcontextprotocolチームとAnthropicチームに感謝します。https://modelcontextprotocol.io/introduction
• このプロジェクトを実現し、スポンサーとして支援してくださったMarketplaceAdProsに感謝します。