MCP Adobe Aep

🚀 Adobe 経験プラットフォームサーバ MCP

このサーバは Node.js をベースに構築されており、Adobe Experience Platform (AEP) との統合を可能にする包括的な API インターフェイスを提供します。模式、データセット、セグメント、プロファイルなど、様々な AEP 機能をサポートしています。

✨ 主な機能

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

📦 インストール

前提条件

• Node.js (v14 以上)
• npm または yarn
• API アクセス権を持つ Adobe Experience Platform アカウント
• AEP 統合が設定された Adobe 開発者コンソールプロジェクト

インストール手順

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

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

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

npm install

3. ルートディレクトリに .env ファイルを作成し、Adobe の認証情報を入力します:

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. pull request を送信する

テスト

テストスイートを実行するには、以下のコマンドを実行します:

npm test

📄 ライセンス

ISC