Skip to main content
Glama

ALECS - MCP server for 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

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

ServiceToolsKey Features
🏢 Property Manager25CDN configs, rules, activations
🛡️ Security47Network lists, WAF policies
🌐 Edge DNS12DNS zones, records, DNSSEC
📋 Includes10Include configurations
🔗 Edge Hostnames10Hostname management
📊 Reporting9Analytics and metrics
🔐 Certificates8SSL/TLS lifecycle management
⚡ Fast Purge8Cache invalidation
🔧 Workflow7Orchestration and automation
🌐 Hostname Mgmt5Advanced hostname operations
📦 Bulk Operations5Batch processing
🚨 SIEM4Security monitoring
🏗️ Rule Tree4Rule processing
📊 CPCode2Traffic 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

🐳 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 DocumentationComplete developer guide
Developer OnboardingNew team member onboarding
API ReferenceAll 156 tools documented
Getting StartedSetup tutorials
Architecture ExplainerComprehensive architecture guide
Architecture Quick ReferenceQuick architecture lookup
Visual ArchitectureArchitecture diagrams
Architecture Deep DiveTechnical system design
Development GuideCoding standards & patterns
Testing StrategyComprehensive testing approach
Deployment GuideProduction deployment
Operations RunbookProduction operations & troubleshooting
Tool CreationBuild 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

Install 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 -
                        235
                        Python
                        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 -
                        4
                        345
                        3
                        JavaScript
                        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
                        Python
                        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 -
                        8
                        Python
                        • 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