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 许可证。