MCP Adobe Experience Platform Server

MCP Adobe Experience Platform Server

Adobe Experience Platform（AEP）との統合を実現する、包括的な API インターフェースを提供する Node.js サーバーです。スキーマ、データセット、セグメント、プロファイルなど、さまざまな AEP 機能に対応しています。

機能

• スキーマ管理
• データセット操作
• セグメント管理
• データ取り込み
• プロファイル管理
• クエリサービス
• デスティネーション管理
• Swagger ドキュメント
• 入力検証
• エラー処理

前提条件

• Node.js（v14 以降）
• npm または yarn
• API アクセス権を持つ Adobe Experience Platform アカウント
• AEP 統合を設定した Adobe Developer Console プロジェクト

セットアップ

1. リポジトリをクローンします：

git clone https://github.com/praveensharmajava/mcp-adobe-aep.git
cd mcp-adobe-aep

2. 依存関係をインストールします：

npm install

3. Adobe の認証情報を記載した .env ファイルをルートディレクトリに作成します：

PORT=3000
AEP_BASE_URL=https://platform.adobe.io
AEP_CLIENT_ID=your_client_id
AEP_CLIENT_SECRET=your_client_secret
AEP_ORG_ID=your_organization_id

4. プロジェクトをビルドします：

npm run build

5. サーバーを起動します：

npm start

開発時：

npm run dev

API ドキュメント

サーバーの起動後、次の場所から Swagger ドキュメントにアクセスできます：

http://localhost:3000/api-docs

API エンドポイント

スキーマ

• GET /api/aep/schemas - すべてのスキーマを一覧表示
• POST /api/aep/schemas - 新しいスキーマを作成

データセット

• GET /api/aep/datasets - すべてのデータセットを一覧表示
• POST /api/aep/datasets - 新しいデータセットを作成

セグメント

• GET /api/aep/segments - すべてのセグメントを一覧表示
• POST /api/aep/segments - 新しいセグメントを作成

データ取り込み

• POST /api/aep/ingest/:datasetId - データセットにデータを取り込む

プロファイル

• GET /api/aep/profiles/:identityValue - 統合プロファイルを取得

クエリサービス

• POST /api/aep/query - クエリを実行

デスティネーション

• GET /api/aep/destinations - すべてのデスティネーションを一覧表示
• POST /api/aep/destinations/:destinationId/activate/:segmentId - セグメントをアクティベート

エラー処理

サーバーには、次のエラーに対応する包括的なエラー処理が含まれています：

• Adobe API エラー
• 接続の問題
• 検証エラー
• 内部サーバーエラー

開発

プロジェクトに貢献するには：

1. 新しいブランチを作成します
2. 変更を加えます
3. テストを作成または更新します
4. プルリクエストを送信します

テスト

テストスイートを実行します：

npm test

ライセンス

ISC