MCP Adobe Experience Platform 服务器

这是一个 Node.js 服务器，为 Adobe Experience Platform (AEP) 集成提供全面的 API 接口。它支持各种 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. 在根目录中创建一个 .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. 提交拉取请求

测试

运行测试套件：

npm test

许可证

ISC