MCP Adobe Experience Platform Server
by praveensharmajava
This is a Node.js server providing a comprehensive API interface for Adobe Experience Platform (AEP) integration. It supports various AEP functionalities including schemas, datasets, segments, profiles, and more.
View on GitHub
Last updated: N/A
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
- Clone the repository:
git clone https://github.com/praveensharmajava/mcp-adobe-aep.git
cd mcp-adobe-aep
- Install dependencies:
npm install
- 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
- Build the project:
npm run build
- 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:
- Create a new branch
- Make your changes
- Write/update tests
- Submit a pull request
Testing
Run the test suite:
npm test
License
ISC