MCP Adobe Aep

🚀 Adobe 經驗平臺服務器 MCP

這是一個基於 Node.js 的服務器，為您提供與 Adobe Experience Platform (AEP) 集成的全面 API 接口。它支持多種 AEP 功能，涵蓋模式、數據集、分段、配置文件等多個方面，助力您高效使用 AEP 服務。

🚀 快速開始

本服務器基於 Node.js 構建，為您提供與 Adobe Experience Platform (AEP) 集成的全面 API 接口。下面將為您介紹如何快速啟動該服務器。

✨ 主要特性

• 模式管理
• 數據集操作
• 分段管理
• 數據攝入
• 配置文件管理
• 查詢服務
• 目的地管理
• 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

💻 使用示例

基礎用法

啟動服務器後，您可以通過以下地址訪問 Swagger 文檔，瞭解 API 的詳細信息：

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 許可證。