alecs-mcp-server-akamai

🚀 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

🎨 Natural Language Examples

"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"

✅ 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

🤝 Contributing

We welcome contributions! Check out our Contributing Guide to get started.

📄 License

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