alecs-mcp-server-akamai by henrikaslund - MCP Server

🚀 ALECS MCP Server for Akamai

A Launchgrid for Edge & Cloud Services

AI-powered Akamai CDN management through natural language

🔧 156 Tools • 🌐 15 Services • 🔐 Full EdgeRC Support • ⚡ Production Ready

🎯 What is ALECS?

ALECS bridges the gap between AI tools and Akamai's Connected Cloud Platform. Ask Claude, Cursor, or any MCP-compatible tool to manage your Akamai infrastructure using natural language and minimize context switching when creating Infrastructure-as-Code!

"List my Akamai properties"          →  Complete property inventory
"Create a DNS zone for example.com"  →  Zone created and configured
"Purge cache for /images/*"          →  Cache invalidated instantly
"Check SSL certificate status"       →  Validation progress shown

🎉 One-Click Installation

Claude Desktop

📱 Install

macOS:

curl -sSL https://raw.githubusercontent.com/acedergren/alecs-mcp-server-akamai/main/scripts/install-claude-desktop.sh | bash

Windows:

# Download and run installation script
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/acedergren/alecs-mcp-server-akamai/main/scripts/install-claude-desktop.sh" -OutFile "install-claude-desktop.sh"
bash install-claude-desktop.sh

Linux:

curl -sSL https://raw.githubusercontent.com/acedergren/alecs-mcp-server-akamai/main/scripts/install-claude-desktop.sh | bash

Cursor

🎯 Install

One-click button:

Auto-install script:

curl -sSL https://raw.githubusercontent.com/acedergren/alecs-mcp-server-akamai/main/scripts/install-cursor.sh | bash

LM Studio

🎬 Install

One-click button:

Auto-install script:

curl -sSL https://raw.githubusercontent.com/acedergren/alecs-mcp-server-akamai/main/scripts/install-lmstudio.sh | bash

VS Code

💻 Install

Extension + Server:

curl -sSL https://raw.githubusercontent.com/acedergren/alecs-mcp-server-akamai/main/scripts/install-vscode.sh | bash

Manual Setup:

Install MCP extension
Cmd/Ctrl + Shift + P
"MCP: Add Server"
Command: alecs

Windsurf

🌊 Install

Auto-configure:

curl -sSL https://raw.githubusercontent.com/acedergren/alecs-mcp-server-akamai/main/scripts/install-windsurf.sh | bash

Manual Setup:

Open Windsurf Settings
Navigate to MCP Servers
Add server with command: alecs

Claude Code

⚡ Install

Simple command:

claude mcp add alecs-akamai alecs

Verify:

claude mcp list

More AI Tools Coming Soon...

📦 Quick Start

1. Install ALECS

Choose your preferred method:

NPM

📦 Install

Global install:

npm install -g alecs-mcp-server-akamai

Verify:

alecs --version

Homebrew

🍺 Install

macOS/Linux:

curl -sSL https://raw.githubusercontent.com/acedergren/alecs-mcp-server-akamai/main/scripts/install-homebrew.sh | bash

Manual:

brew install node
npm install -g alecs-mcp-server-akamai

Docker

🐳 Install

Quick start:

docker run -it --env-file .env ghcr.io/acedergren/alecs-mcp-server-akamai:latest

See full Docker section below for more options

2. Configure Akamai

Create ~/.edgerc with your credentials:

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

3. Choose Your AI Tool

Pick your favorite AI assistant and use the one-click installers above! 🚀

🌟 Features

🔧 156 Tools Complete Akamai API coverage	🏢 Multi-Customer Manage multiple accounts	🔒 Secure EdgeGrid authentication	🤖 AI-Native Natural language control
🏷️ ID Translation Human-readable names	🗺️ Hostname Routing Resource relationships	⚡ Performance Smart caching & optimization	📊 Type Safety Full TypeScript coverage

🛠️ Service Coverage

Service	Tools	Key Features
🏢 Property Manager	25	CDN configs, rules, activations
🛡️ Security	47	Network lists, WAF policies
🌐 Edge DNS	12	DNS zones, records, DNSSEC
📋 Includes	10	Include configurations
🔗 Edge Hostnames	10	Hostname management
📊 Reporting	9	Analytics and metrics
🔐 Certificates	8	SSL/TLS lifecycle management
⚡ Fast Purge	8	Cache invalidation
🔧 Workflow	7	Orchestration and automation
🌐 Hostname Mgmt	5	Advanced hostname operations
📦 Bulk Operations	5	Batch processing
🚨 SIEM	4	Security monitoring
🏗️ Rule Tree	4	Rule processing
📊 CPCode	2	Traffic analysis codes

🎨 Natural Language Examples

🗣️ What You Say

"List my properties"
"Create DNS zone for example.com"
"Purge cache for /images/*"
"Check my SSL certificates"
"Show traffic for last 7 days"
"Add IP 192.168.1.0/24 to blocklist"

🤖 What ALECS Does

✅ property_list → Full inventory
✅ dns_zone_create → Zone configured
✅ fastpurge_url → Cache cleared
✅ certificate_status → SSL validated
✅ traffic_report → Analytics shown
✅ network_list_add → IP blocked

🏗️ Architecture

graph LR
    A[🤖 AI Assistant] --> B[🚀 ALECS Server]
    B --> C[🌐 Akamai APIs]

    subgraph "🔧 ALECS Components"
        B1[📡 MCP Protocol]
        B2[🔐 EdgeGrid Auth]
        B3[📋 Tool Registry]
        B4[🏪 Service Modules]
    end

    subgraph "🌐 Akamai Services"
        C1[🏢 Property Manager]
        C2[🌍 Edge DNS]
        C3[🔐 Certificates]
        C4[🛡️ Security]
        C5[⚡ Fast Purge]
    end

    B --> B1
    B1 --> B2
    B2 --> B3
    B3 --> B4
    B4 --> C1
    B4 --> C2
    B4 --> C3
    B4 --> C4
    B4 --> C5

🐳 Docker & Deployment

Quick Start

# Standard I/O for Claude Desktop (default)
docker run -it --env-file .env ghcr.io/acedergren/alecs-mcp-server-akamai:latest

# Streamable HTTP for web/CDN deployment
docker run -it -p 8080:8080 -e MCP_TRANSPORT=streamable-http --env-file .env ghcr.io/acedergren/alecs-mcp-server-akamai:latest

Transport Options

# Available transports
MCP_TRANSPORT=stdio           # Default - Claude Desktop, Cursor, CLI tools
MCP_TRANSPORT=streamable-http # Web clients, CDN deployment (recommended)
MCP_TRANSPORT=websocket       # Real-time bidirectional communication
MCP_TRANSPORT=sse             # Legacy Server-Sent Events (deprecated)

# Transport-specific configuration
HTTP_PORT=8080                # Port for streamable HTTP (default: 8080)
HTTP_HOST=0.0.0.0            # Host for streamable HTTP
HTTP_PATH=/mcp               # Base path for HTTP endpoints
CORS_ENABLED=true            # Enable CORS for browser clients

Available Docker Images

docker pull ghcr.io/acedergren/alecs-mcp-server-akamai:latest    # Full server
docker pull ghcr.io/acedergren/alecs-mcp-server-akamai:modular   # Microservices
docker pull ghcr.io/acedergren/alecs-mcp-server-akamai:websocket # WebSocket
docker pull ghcr.io/acedergren/alecs-mcp-server-akamai:http      # Streamable HTTP

🆕 OpenAPI-Driven Development

ALECS now features automatic tool generation from OpenAPI specifications:

# Generate new domain from API spec
alecs generate-from-api --spec ./openapi.json --domain mydomain

# Update existing tools when APIs change
alecs generate-from-api --spec ./api-v2.json --domain property --update

# Migrate legacy tools to OpenAPI patterns
alecs generate-from-api --spec ./api.json --tool ./dns-tools.ts --migrate

Benefits:

🚀 10x faster tool development
🔧 Always up-to-date with latest API changes
📝 Type-safe with automatic Zod schema generation
🔄 Smart updates preserve custom logic
🎯 Zero manual work for standard CRUD operations

📚 Documentation

📖 Guide	📝 Description
	Complete developer guide
	New team member onboarding
	All 156 tools documented
	Setup tutorials
	Comprehensive architecture guide
	Quick architecture lookup
	Architecture diagrams
	Technical system design
	Coding standards & patterns
	Comprehensive testing approach
	Production deployment
	Production operations & troubleshooting
	Build custom tools & use OpenAPI

🤝 Contributing

We welcome contributions! Check out our to get started.

🐛 Found a bug? Report it 💡 Have an idea? Suggest it ❓ Need help? Ask us

📄 License

GNU Affero General Public License v3.0 (AGPL-3.0) - see

🌟 Star us on GitHub • 📦 Follow on NPM • 🐳 Use with Docker

Built with ❤️ for Akamai by Alexander Cedergren, alex@solutionsedge.io