🚀 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

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

One-click button:

Auto-install script:

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

One-click button:

Auto-install script:

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

Extension + Server:

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

Manual Setup:

1. Install MCP extension
2. Cmd/Ctrl + Shift + P
3. "MCP: Add Server"
4. Command: alecs

Auto-configure:

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

Manual Setup:

1. Open Windsurf Settings
2. Navigate to MCP Servers
3. Add server with command: alecs

Simple command:

claude mcp add alecs-akamai alecs

Verify:

claude mcp list

📦 Quick Start

1. Install ALECS

Choose your preferred method:

Global install:

npm install -g alecs-mcp-server-akamai

Verify:

alecs --version

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

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

🛠️ 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
Developer Documentation	Complete developer guide
Developer Onboarding	New team member onboarding
API Reference	All 156 tools documented
Getting Started	Setup tutorials
Architecture Explainer	Comprehensive architecture guide
Architecture Quick Reference	Quick architecture lookup
Visual Architecture	Architecture diagrams
Architecture Deep Dive	Technical system design
Development Guide	Coding standards & patterns
Testing Strategy	Comprehensive testing approach
Deployment Guide	Production deployment
Operations Runbook	Production operations & troubleshooting
Tool Creation	Build custom tools & use OpenAPI

🤝 Contributing

We welcome contributions! Check out our Contributing Guide 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 LICENSE

---

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

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