MCP Adobe Experience Platform Server

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