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

Related MCP server: MCPfinder Server

๐ŸŽ‰ 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

One-click Deploy
A
security โ€“ no known vulnerabilities
-
license - not tested
A
quality - confirmed to work

Latest Blog Posts

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