Skip to main content
Glama

ALECS - MCP server for Akamai

by henrikaslund

🚀 ALECS MCP Server for Akamai

A Launchgrid for Edge & Cloud Services

AI-powered Akamai CDN management through natural language

npm version GitHub release Build Status Add to Cursor

🔧 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: Add to Cursor

Auto-install script:

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

One-click button: Add to LM Studio

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

Deploy Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

MCP server for Akamai APIs. 198 tools covering Property Manager, Edge DNS, CPS, WAF, and reporting. Built with TypeScript, featuring modular architecture, comprehensive testing, and multi-account support. Make Akamai accessible to AI assistants.

  1. 🎯 What is ALECS?
    1. 🎉 One-Click Installation
      1. 📦 Quick Start
        1. 1. Install ALECS
        2. 2. Configure Akamai
        3. 3. Choose Your AI Tool
      2. 🌟 Features
        1. 🛠️ Service Coverage
          1. 🎨 Natural Language Examples
            1. 🏗️ Architecture
              1. 🐳 Docker & Deployment
                1. Quick Start
                2. Transport Options
                3. Available Docker Images
              2. 🆕 OpenAPI-Driven Development
                1. 📚 Documentation
                  1. 🤝 Contributing
                    1. 📄 License

                      Related MCP Servers

                      • -
                        security
                        A
                        license
                        -
                        quality
                        MCP server providing access to ACI.dev managed functions (tools) either directly from specific apps or through meta functions that dynamically discover and execute any available function based on user intent.
                        Last updated -
                        246
                        MIT License
                        • Apple
                      • A
                        security
                        A
                        license
                        A
                        quality
                        Enables AI assistants to discover, retrieve details about, and manage MCP (Model Context Protocol) servers that provide additional tools and capabilities on demand.
                        Last updated -
                        5
                        14
                        8
                        AGPL 3.0
                        • Linux
                        • Apple
                      • -
                        security
                        A
                        license
                        -
                        quality
                        A collection of custom MCP servers providing various AI-powered capabilities including web search, YouTube video analysis, GitHub repository analysis, reasoning, code generation/execution, and web crawling.
                        Last updated -
                        2
                        MIT License
                      • -
                        security
                        F
                        license
                        -
                        quality
                        A MCP server that uses Amap API to provide location-based services, allowing users to get geographic information based on IP addresses and search for nearby points of interest.
                        Last updated -
                        13
                        • Linux
                        • Apple

                      View all related MCP servers

                      MCP directory API

                      We provide all the information about MCP servers via our MCP API.

                      curl -X GET 'https://glama.ai/api/mcp/v1/servers/henrikaslund/alecs-mcp-server-akamai'

                      If you have feedback or need assistance with the MCP directory API, please join our Discord server