acedergren/alecs-mcp-server-akamai
If you are the rightful owner of alecs-mcp-server-akamai and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The ALECS MCP Server for Akamai is a Model Context Protocol server designed to integrate AI-powered automation with Akamai CDN management, providing a seamless interface for managing CDN properties, DNS zones, certificates, and more.
A Launchgrid for Edge & Cloud Services
A Model Context Protocol (MCP) server that brings AI-powered automation to Akamai CDN management
Compatible with: Claude Desktop โข Claude Code โข Cursor โข Windsurf โข VS Code โข Any MCP Client
Quick Start โข Features โข Documentation โข Contributing
๐ Quick Start
Install from NPM
# Install globally
npm install -g alecs-mcp-server-akamai
# Verify installation
alecs --version
# Run the main server (all 198+ tools)
alecs
# Or run specific service modules
alecs start:property # Property management only
alecs start:dns # DNS management only
alecs start:certs # Certificate management only
# See all variants: alecs --help
๐ - Learn about all server variants and configurations
Configure Akamai Credentials
Create ~/.edgerc
with your Akamai API credentials:
[default]
client_secret = your_client_secret
host = your_host.luna.akamaiapis.net
access_token = your_access_token
client_token = your_client_token
; Optional: Add more customer sections
[customer-name]
client_secret = customer_client_secret
host = customer_host.luna.akamaiapis.net
access_token = customer_access_token
client_token = customer_client_token
Add to Claude Desktop
# macOS
echo '{"mcpServers":{"alecs-akamai":{"command":"alecs","args":[],"env":{"MCP_TRANSPORT":"stdio"}}}}' > ~/Library/Application\ Support/Claude/claude_desktop_config.json
# Windows
echo {"mcpServers":{"alecs-akamai":{"command":"alecs","args":[],"env":{"MCP_TRANSPORT":"stdio"}}}} > %APPDATA%\Claude\claude_desktop_config.json
# Linux
echo '{"mcpServers":{"alecs-akamai":{"command":"alecs","args":[],"env":{"MCP_TRANSPORT":"stdio"}}}}' > ~/.config/Claude/claude_desktop_config.json
Add to Claude Code
# One-line installation
claude mcp add alecs-akamai alecs
Install from Source
# Clone and install
git clone https://github.com/acedergren/alecs-mcp-server-akamai.git
cd alecs-mcp-server-akamai
npm install
# Build
npm run build
Docker
# Pull from Docker Hub (recommended)
docker pull acedergr/alecs-mcp-server-akamai:latest
# Or pull from GitHub Container Registry
docker pull ghcr.io/acedergren/alecs-mcp-server-akamai:latest
# Run with environment variables
docker run -it --env-file .env acedergr/alecs-mcp-server-akamai:latest
Available Docker Tags
Tag | Description | Size |
---|---|---|
latest | Main server with PM2 management | ~200MB |
modular | Microservices architecture | ~180MB |
websocket | WebSocket transport | ~170MB |
sse | Server-Sent Events transport | ~170MB |
๐ Integration Guide
Quick Reference
Tool | Installation Command |
---|---|
Claude Desktop | See platform-specific commands below |
Claude Code | claude mcp add alecs-akamai alecs |
VS Code | Use MCP extension settings |
Cursor | Add to MCP config |
Windsurf | Configure in settings |
Detailed Setup Instructions
Claude Desktop (Click to expand)
macOS:
echo '{"mcpServers":{"alecs-akamai":{"command":"alecs","args":[],"env":{"MCP_TRANSPORT":"stdio"}}}}' > ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows:
echo {"mcpServers":{"alecs-akamai":{"command":"alecs","args":[],"env":{"MCP_TRANSPORT":"stdio"}}}} > %APPDATA%\Claude\claude_desktop_config.json
Linux:
echo '{"mcpServers":{"alecs-akamai":{"command":"alecs","args":[],"env":{"MCP_TRANSPORT":"stdio"}}}}' > ~/.config/Claude/claude_desktop_config.json
Restart Claude Desktop after configuration.
Claude Code (Click to expand)
# Install Claude Code CLI if not already installed
npm install -g claude-code
# Add ALECS MCP server
claude mcp add alecs-akamai alecs
# Verify installation
claude mcp list
๐ค Works With Your Favorite AI Tools
Claude Desktop Native MCP support |
Claude Code CLI with MCP |
Cursor IDE AI-first editor |
Windsurf Agentic IDE |
VS Code MCP extensions |
![]() Any MCP Client Open protocol |
๐ Natural Language, Real Actions
# Ask: "List my Akamai properties"
# Get: Complete list with versions, hostnames, and activation status
# Ask: "Show DNS records for example.com"
# Get: All A, CNAME, MX records with TTLs
# Ask: "Purge cache for /images/*"
# Get: Fast purge executed, confirmation in seconds
๐ Stats & Features
Stat | Value |
---|---|
๐ง Tools Available | |
๐ Services Supported | |
๐ TypeScript Files | |
๐งช Test Coverage | |
โก Response Time | |
๐พ Memory Usage |
๐ Supported Akamai Services
๐ Overview
ALECS bridges AI assistants (like Claude) with Akamai's powerful CDN platform through the Model Context Protocol. It provides a type-safe, production-ready interface for managing properties, DNS zones, certificates, and more.
๐ Key Features
![]() Multi-Customer Manage multiple accounts via .edgerc sections |
![]() Secure Auth EdgeGrid authentication with account switching |
![]() Full Coverage All major Akamai APIs in one interface |
![]() AI-Native Works with all MCP-compatible tools |
๐๏ธ Architecture
graph TB
subgraph "AI Assistant"
Claude[Claude Desktop/API]
end
subgraph "ALECS MCP Server"
MCP[MCP Protocol Handler]
Auth[EdgeGrid Auth]
Tools[Tool Registry]
subgraph "Service Modules"
PM[Property Manager]
DNS[Edge DNS]
CPS[CPS/Certificates]
NL[Network Lists]
FP[Fast Purge]
AS[App Security]
end
end
subgraph "Akamai Platform"
API[Akamai APIs]
Edge[Edge Network]
end
Claude -->|MCP Protocol| MCP
MCP --> Tools
Tools --> PM & DNS & CPS & NL & FP & AS
PM & DNS & CPS & NL & FP & AS --> Auth
Auth -->|EdgeGrid| API
API --> Edge
๐ ๏ธ Available Tools
Property Management
property.list
- List CDN propertiesproperty.create
- Create new propertyproperty.activate
- Deploy to staging/productionproperty.rules.get
- Get configuration rulesproperty.rules.update
- Modify behaviors
DNS Management
dns.zone.list
- List DNS zonesdns.zone.create
- Create zonesdns.record.create
- Add DNS recordsdns.record.update
- Modify recordsdns.zone.activate
- Activate changes
Certificate Management
certs.dv.create
- Create DV certificatescerts.enrollment.status
- Check validationcerts.challenges.get
- Get validation records
Content Control
fastpurge.url
- Purge by URLfastpurge.cpcode
- Purge by CP codenetwork-lists.create
- Create IP/geo listsnetwork-lists.update
- Modify access lists
๐ง Installation
For Claude Desktop
- Install ALECS:
./install.sh
# Choose option 4 for Claude Desktop
- The installer creates a config file. Copy it to Claude:
cp claude_desktop_config.json ~/Library/Application\ Support/Claude/
- Restart Claude Desktop
For Development
# Install dependencies
npm install
# Build TypeScript
npm run build
# Run in stdio mode (for testing)
npm run dev
๐ Documentation
- - System design and components
- - Quick tutorials
- - Detailed tool documentation
- - How-to guides and examples
๐งช Testing
# Run all tests
npm test
# Run specific test suite
npm test -- property-tools
# Type checking
npm run typecheck
๐ Security
- Credentials stored in
~/.edgerc
(never in code) - EdgeGrid authentication for all API calls
- Account switching via secure headers
- No OAuth required - simplified security model
.edgerc
files are excluded from npm package
โ ๏ธ Important Security Note
When installing from npm, you must create your own .edgerc
file with your Akamai credentials. The npm package does NOT include any credential files.
๐ง Troubleshooting
Common Setup Issues
"Command not found: alecs"
# Ensure global npm bin is in PATH
export PATH="$PATH:$(npm bin -g)"
# Or reinstall globally
npm install -g alecs-mcp-server-akamai
"No .edgerc file found"
# Create the file in your home directory
touch ~/.edgerc
chmod 600 ~/.edgerc
# Then add your Akamai credentials
"Claude Desktop doesn't see the server"
- Restart Claude Desktop after configuration
- Check the config file location is correct for your OS
- Ensure
alecs
command works in terminal first
๐ค Contributing
- Fork the repository
- Create a feature branch
- Make your changes with tests
- Run
npm test
andnpm run typecheck
- Submit a pull request
๐ License
GNU Affero General Public License v3.0 (AGPL-3.0) with additional terms - see file
Important License Terms:
- Any modifications must be contributed back to the original project within 30 days of production deployment
- Production use must display "Powered by ALECS MCP Server" with link to this repository
- Network use requires source code disclosure
- See for contribution requirements
๐ Support
Built with โค๏ธ for the Akamai and AI communities