MCP Adobe Experience Platform Server

This is a Node.js server that provides a comprehensive API interface for Adobe Experience Platform (AEP) integration. It supports various AEP functionalities including schemas, datasets, segments, profiles, and more.

Features

• Schema Management
• Dataset Operations
• Segment Management
• Data Ingestion
• Profile Management
• Query Service
• Destinations Management
• Swagger Documentation
• Input Validation
• Error Handling

Prerequisites

• Node.js (v14 or higher)
• npm or yarn
• Adobe Experience Platform account with API access
• Adobe Developer Console project with AEP integration

Setup

1. Clone the repository:

git clone https://github.com/praveensharmajava/mcp-adobe-aep.git
cd mcp-adobe-aep

2. Install dependencies:

npm install

3. Create a .env file in the root directory with your Adobe credentials:

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. Build the project:

npm run build

5. Start the server:

npm start

For development:

npm run dev

API Documentation

Once the server is running, you can access the Swagger documentation at:

http://localhost:3000/api-docs

API Endpoints

Schemas

• GET /api/aep/schemas - List all schemas
• POST /api/aep/schemas - Create a new schema

Datasets

• GET /api/aep/datasets - List all datasets
• POST /api/aep/datasets - Create a new dataset

Segments

• GET /api/aep/segments - List all segments
• POST /api/aep/segments - Create a new segment

Data Ingestion

• POST /api/aep/ingest/:datasetId - Ingest data into a dataset

Profiles

• GET /api/aep/profiles/:identityValue - Get unified profile

Query Service

• POST /api/aep/query - Execute a query

Destinations

• GET /api/aep/destinations - List all destinations
• POST /api/aep/destinations/:destinationId/activate/:segmentId - Activate a segment

Error Handling

The server includes comprehensive error handling for:

• Adobe API errors
• Connection issues
• Validation errors
• Internal server errors

Development

To contribute to the project:

1. Create a new branch
2. Make your changes
3. Write/update tests
4. Submit a pull request

Testing

Run the test suite:

npm test

License

ISC