AEM EDS MCP Server

An MCP (Model Context Protocol) server that provides 10 consolidated tools for AEM Edge Delivery Services (EDS) via the Helix Admin API.

📦 Installation

NPM Installation (Recommended)

# Install globally
npm install -g @neerajgrg93/aem-eds-mcp-server

# Or install locally
npm install @neerajgrg93/aem-eds-mcp-server

Alternative: Docker Setup

# Clone the repository
git clone https://github.com/neerajgrg93/aem-mcp-servers.git
cd aem-mcp-servers/aem-eds

# Run the interactive setup
make setup

# Follow the prompts to:
# 1. Enter your API tokens
# 2. Build the Docker image
# 3. Get instructions for enabling in Cursor

🔧 Development Setup

Run directly from source:

# Clone and setup
git clone https://github.com/neerajgrg93/aem-mcp-servers.git
cd aem-mcp-servers/aem-eds
npm install

# Create .env file with your token
echo "HELIX_ADMIN_API_TOKEN=your_token_here" > .env

# Start the server
npm start

🎯 Enabling in Cursor

Option 1: Docker Setup (Recommended)

Add this to your Cursor MCP settings:

{
  "mcpServers": {
    "aem-eds-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env-file",
        ".env",
        "aem-eds-mcp"
      ]
    }
  }
}

Option 2: Local Node.js Setup

Add this to your Cursor MCP settings:

{
  "mcpServers": {
    "aem-eds-mcp-server": {
      "command": "node",
      "args": ["/path/to/aem-eds-mcp-server/src/index.js"],
      "env": {
        "HELIX_ADMIN_API_TOKEN": "your_token_here"
      }
    }
  }
}

🔑 Required API Token

You'll need this token to use the MCP server:

HELIX_ADMIN_API_TOKEN (Required)

• Get from admin.hlx.page/login
• Or follow instructions at aem.live/docs/admin-apikeys

🧹 Cleanup

If using Docker setup:

make clean  # Removes Docker image and .env file

📚 Additional Resources

• Full Documentation
• Tools Documentation - Comprehensive list of all available tools
• API Reference
• Configuration Guide
• Contributing Guidelines

🤝 Contributing

We welcome contributions! See our Contributing Guidelines for details.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.