alecs-mcp-server-akamai

acedergren/alecs-mcp-server-akamai

3.4

If you are the rightful owner of alecs-mcp-server-akamai and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The ALECS MCP Server for Akamai is a Model Context Protocol server designed to integrate AI-powered automation with Akamai CDN management, providing a seamless interface for managing CDN properties, DNS zones, certificates, and more.

๐Ÿš€ ALECS MCP Server for Akamai

A Launchgrid for Edge & Cloud Services

A Model Context Protocol (MCP) server that brings AI-powered automation to Akamai CDN management

Compatible with: Claude Desktop โ€ข Claude Code โ€ข Cursor โ€ข Windsurf โ€ข VS Code โ€ข Any MCP Client

Quick Start โ€ข Features โ€ข Documentation โ€ข Contributing

๐Ÿ“Š Latest Release Docs


๐Ÿš€ Quick Start

Install from NPM

# Install globally
npm install -g alecs-mcp-server-akamai

# Verify installation
alecs --version

# Run the main server (all 198+ tools)
alecs

# Or run specific service modules
alecs start:property  # Property management only
alecs start:dns       # DNS management only
alecs start:certs     # Certificate management only
# See all variants: alecs --help

๐Ÿ“– - Learn about all server variants and configurations

Configure Akamai Credentials

Create ~/.edgerc with your Akamai API credentials:

[default]
client_secret = your_client_secret
host = your_host.luna.akamaiapis.net
access_token = your_access_token
client_token = your_client_token

; Optional: Add more customer sections
[customer-name]
client_secret = customer_client_secret
host = customer_host.luna.akamaiapis.net
access_token = customer_access_token
client_token = customer_client_token

Add to Claude Desktop

# macOS
echo '{"mcpServers":{"alecs-akamai":{"command":"alecs","args":[],"env":{"MCP_TRANSPORT":"stdio"}}}}' > ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Windows
echo {"mcpServers":{"alecs-akamai":{"command":"alecs","args":[],"env":{"MCP_TRANSPORT":"stdio"}}}} > %APPDATA%\Claude\claude_desktop_config.json

# Linux
echo '{"mcpServers":{"alecs-akamai":{"command":"alecs","args":[],"env":{"MCP_TRANSPORT":"stdio"}}}}' > ~/.config/Claude/claude_desktop_config.json

Add to Claude Code

# One-line installation
claude mcp add alecs-akamai alecs

Install from Source

# Clone and install
git clone https://github.com/acedergren/alecs-mcp-server-akamai.git
cd alecs-mcp-server-akamai
npm install

# Build
npm run build

Docker

# Pull from Docker Hub (recommended)
docker pull acedergr/alecs-mcp-server-akamai:latest

# Or pull from GitHub Container Registry
docker pull ghcr.io/acedergren/alecs-mcp-server-akamai:latest

# Run with environment variables
docker run -it --env-file .env acedergr/alecs-mcp-server-akamai:latest
Available Docker Tags
TagDescriptionSize
latestMain server with PM2 management~200MB
modularMicroservices architecture~180MB
websocketWebSocket transport~170MB
sseServer-Sent Events transport~170MB

๐Ÿ“– Integration Guide

Quick Reference

ToolInstallation Command
Claude DesktopSee platform-specific commands below
Claude Codeclaude mcp add alecs-akamai alecs
VS CodeUse MCP extension settings
CursorAdd to MCP config
WindsurfConfigure in settings

Detailed Setup Instructions

Claude Desktop (Click to expand)

macOS:

echo '{"mcpServers":{"alecs-akamai":{"command":"alecs","args":[],"env":{"MCP_TRANSPORT":"stdio"}}}}' > ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows:

echo {"mcpServers":{"alecs-akamai":{"command":"alecs","args":[],"env":{"MCP_TRANSPORT":"stdio"}}}} > %APPDATA%\Claude\claude_desktop_config.json

Linux:

echo '{"mcpServers":{"alecs-akamai":{"command":"alecs","args":[],"env":{"MCP_TRANSPORT":"stdio"}}}}' > ~/.config/Claude/claude_desktop_config.json

Restart Claude Desktop after configuration.

Claude Code (Click to expand)
# Install Claude Code CLI if not already installed
npm install -g claude-code

# Add ALECS MCP server
claude mcp add alecs-akamai alecs

# Verify installation
claude mcp list

๐Ÿค Works With Your Favorite AI Tools


Claude Desktop
Native MCP support

Claude Code
CLI with MCP

Cursor IDE
AI-first editor

Windsurf
Agentic IDE

VS Code
MCP extensions

Any MCP Client
Open protocol

๐ŸŽ† Natural Language, Real Actions

# Ask: "List my Akamai properties"
# Get: Complete list with versions, hostnames, and activation status

# Ask: "Show DNS records for example.com"
# Get: All A, CNAME, MX records with TTLs

# Ask: "Purge cache for /images/*"
# Get: Fast purge executed, confirmation in seconds

๐Ÿ† Stats & Features

StatValue
๐Ÿ”ง Tools Available
๐ŸŒ Services Supported
๐Ÿ“ TypeScript Files
๐Ÿงช Test Coverage
โšก Response Time
๐Ÿ’พ Memory Usage

๐ŸŒŸ Supported Akamai Services

๐Ÿ“‹ Overview

ALECS bridges AI assistants (like Claude) with Akamai's powerful CDN platform through the Model Context Protocol. It provides a type-safe, production-ready interface for managing properties, DNS zones, certificates, and more.

๐Ÿš€ Key Features


Multi-Customer
Manage multiple accounts
via .edgerc sections

Secure Auth
EdgeGrid authentication
with account switching

Full Coverage
All major Akamai APIs
in one interface

AI-Native
Works with all
MCP-compatible tools

๐Ÿ—๏ธ Architecture

graph TB
    subgraph "AI Assistant"
        Claude[Claude Desktop/API]
    end
    
    subgraph "ALECS MCP Server"
        MCP[MCP Protocol Handler]
        Auth[EdgeGrid Auth]
        Tools[Tool Registry]
        
        subgraph "Service Modules"
            PM[Property Manager]
            DNS[Edge DNS]
            CPS[CPS/Certificates]
            NL[Network Lists]
            FP[Fast Purge]
            AS[App Security]
        end
    end
    
    subgraph "Akamai Platform"
        API[Akamai APIs]
        Edge[Edge Network]
    end
    
    Claude -->|MCP Protocol| MCP
    MCP --> Tools
    Tools --> PM & DNS & CPS & NL & FP & AS
    PM & DNS & CPS & NL & FP & AS --> Auth
    Auth -->|EdgeGrid| API
    API --> Edge

๐Ÿ› ๏ธ Available Tools

Property Management

  • property.list - List CDN properties
  • property.create - Create new property
  • property.activate - Deploy to staging/production
  • property.rules.get - Get configuration rules
  • property.rules.update - Modify behaviors

DNS Management

  • dns.zone.list - List DNS zones
  • dns.zone.create - Create zones
  • dns.record.create - Add DNS records
  • dns.record.update - Modify records
  • dns.zone.activate - Activate changes

Certificate Management

  • certs.dv.create - Create DV certificates
  • certs.enrollment.status - Check validation
  • certs.challenges.get - Get validation records

Content Control

  • fastpurge.url - Purge by URL
  • fastpurge.cpcode - Purge by CP code
  • network-lists.create - Create IP/geo lists
  • network-lists.update - Modify access lists

๐Ÿ”ง Installation

For Claude Desktop

  1. Install ALECS:
./install.sh
# Choose option 4 for Claude Desktop
  1. The installer creates a config file. Copy it to Claude:
cp claude_desktop_config.json ~/Library/Application\ Support/Claude/
  1. Restart Claude Desktop

For Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run in stdio mode (for testing)
npm run dev

๐Ÿ“š Documentation

  • - System design and components
  • - Quick tutorials
  • - Detailed tool documentation
  • - How-to guides and examples

๐Ÿงช Testing

# Run all tests
npm test

# Run specific test suite
npm test -- property-tools

# Type checking
npm run typecheck

๐Ÿ”’ Security

  • Credentials stored in ~/.edgerc (never in code)
  • EdgeGrid authentication for all API calls
  • Account switching via secure headers
  • No OAuth required - simplified security model
  • .edgerc files are excluded from npm package

โš ๏ธ Important Security Note

When installing from npm, you must create your own .edgerc file with your Akamai credentials. The npm package does NOT include any credential files.

๐Ÿ”ง Troubleshooting

Common Setup Issues

"Command not found: alecs"

# Ensure global npm bin is in PATH
export PATH="$PATH:$(npm bin -g)"

# Or reinstall globally
npm install -g alecs-mcp-server-akamai

"No .edgerc file found"

# Create the file in your home directory
touch ~/.edgerc
chmod 600 ~/.edgerc
# Then add your Akamai credentials

"Claude Desktop doesn't see the server"

  1. Restart Claude Desktop after configuration
  2. Check the config file location is correct for your OS
  3. Ensure alecs command works in terminal first

๐Ÿค Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes with tests
  4. Run npm test and npm run typecheck
  5. Submit a pull request

๐Ÿ“„ License

GNU Affero General Public License v3.0 (AGPL-3.0) with additional terms - see file

Important License Terms:

  • Any modifications must be contributed back to the original project within 30 days of production deployment
  • Production use must display "Powered by ALECS MCP Server" with link to this repository
  • Network use requires source code disclosure
  • See for contribution requirements

๐Ÿ†˜ Support


Built with โค๏ธ for the Akamai and AI communities

Trigger CI/CD