🚀 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 开发者控制台项目
安装步骤
- 克隆仓库:
git clone https://github.com/praveensharmajava/mcp-adobe-aep.git
cd mcp-adobe-aep
- 安装依赖项:
npm install
- 在根目录下创建一个
.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
- 构建项目:
npm run build
- 启动服务器:
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 错误
- 连接问题
- 验证错误
- 服务器内部错误
🛠️ 开发贡献
要为项目做出贡献，请按照以下步骤操作：
- 创建新分支
- 应用更改
- 编写或更新测试
- 提交 pull request
🧪 测试
运行测试套件，可使用以下命令：
npm test
📄 许可证
本项目采用 ISC 许可证。