Amazon Ads Manager MCP Server

Amazon Ads Manager MCP サーバー

Amazon Advertising データを管理および分析するための Model Context Protocol（MCP）サーバーです。このサーバーは、Claude Desktop App を通じて LLM が広告データを操作するための標準化されたインターフェースを提供します。

機能

• データベース統合：セキュアな PostgreSQL データベースへの接続が事前設定されています
• API キー認証：API キーの検証によるセキュアなアクセス
• リアルタイム分析：キャンペーンの指標とパフォーマンスデータにアクセスできます
• 自然言語インターフェース：自然言語を使って広告データにクエリできます

インストール

npm install ads-manager-mcp

クイックスタート

1. Claude Desktop App をインストールします
2. 設定ファイル claude-desktop-config.json を作成します：

{
  "name": "Amazon Ads Manager",
  "version": "1.0.4",
  "description": "Connect to your Amazon Advertising data and analyze campaign performance",
  "mcpServers": {
    "ads-manager": {
      "name": "Ads Manager MCP Server",
      "version": "1.0.4",
      "description": "MCP Server for Amazon Advertising data analysis",
      "transport": "sse",
      "endpoint": "https://mcp-server-sync-abhilashreddi.replit.app/mcp/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

3. YOUR_API_KEY_HERE を API キーに置き換えます
4. Claude Desktop App を使って広告データの分析を開始します

利用可能なリソース

• スキーマ：データベース構造とテーブル定義を確認できます
• 指標：広告パフォーマンス指標にアクセスできます
• キャンペーン：キャンペーンの構成と設定を確認できます
• 広告グループ：広告グループの詳細と設定にアクセスできます

利用可能なツール

• analyzeCampaignPerformance：キャンペーンの指標とパフォーマンスを分析します
• analyzeAdGroupPerformance：広告グループの詳細なパフォーマンス分析を取得します
• optimizeBudget：予算の最適化に関する推奨事項を取得します
• query：データベースに対してカスタム SQL クエリを実行します

クエリの例

"Show me the structure of all tables in the database"
"Analyze the performance of campaign ABC123 for the last 30 days"
"What are the key metrics for ad group XYZ789?"
"Give me budget recommendations for all campaigns in profile P123"

API 認証

このサーバーでは API キー認証を使用します。各リクエストには Authorization ヘッダーを含める必要があります：

Authorization: Bearer YOUR_API_KEY

データベース接続

このサーバーは PostgreSQL データベースへの接続を維持します。接続情報はパッケージに事前設定されているため、追加の設定は不要です。

開発

サーバーをローカルで実行するには：

# Install dependencies
npm install

# Start the development server
npm run dev

# Build the package
npm run build

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については LICENSE ファイルをご覧ください。

サポート

サポートが必要な場合は、GitHub リポジトリで issue を作成するか、メンテナーにお問い合わせください。