Skip to main content
Glama

ALECS - MCP server for Akamai

by acedergren
npmGitHub
TypeScript
331
8
  • Apple
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

🚀 ALECS MCP Server for Akamai

📊 Latest Release Docs

Version

🚀 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

📖 Full NPM Variants Guide - 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
TagDescriptionSize
latestMain server with PM2 management~200MB
modularMicroservices architecture~180MB
websocketWebSocket transport~170MB
sseServer-Sent Events transport~170MB

📖 Integration Guide

Quick Reference

ToolInstallation Command
Claude DesktopSee platform-specific commands below
Claude Codeclaude mcp add alecs-akamai alecs
VS CodeUse MCP extension settings
CursorAdd to MCP config
WindsurfConfigure in settings

Detailed Setup Instructions

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.

# 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

🎆 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

StatValue
🔧 Tools AvailableTools
🌐 Services SupportedServices
📝 TypeScript FilesFiles
🧪 Test CoverageCoverage
⚡ Response TimeResponse
💾 Memory UsageMemory

🌟 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

🏗️ Architecture

🛠️ Available Tools

Property Management

  • property.list - List CDN properties
  • property.create - Create new property
  • property.activate - Deploy to staging/production
  • property.rules.get - Get configuration rules
  • property.rules.update - Modify behaviors

DNS Management

  • dns.zone.list - List DNS zones
  • dns.zone.create - Create zones
  • dns.record.create - Add DNS records
  • dns.record.update - Modify records
  • dns.zone.activate - Activate changes

Certificate Management

  • certs.dv.create - Create DV certificates
  • certs.enrollment.status - Check validation
  • certs.challenges.get - Get validation records

Content Control

  • fastpurge.url - Purge by URL
  • fastpurge.cpcode - Purge by CP code
  • network-lists.create - Create IP/geo lists
  • network-lists.update - Modify access lists

🔧 Installation

For Claude Desktop

  1. Install ALECS:
./install.sh # Choose option 4 for Claude Desktop
  1. The installer creates a config file. Copy it to Claude:
cp claude_desktop_config.json ~/Library/Application\ Support/Claude/
  1. Restart Claude Desktop

For Development

# Install dependencies npm install # Build TypeScript npm run build # Run in stdio mode (for testing) npm run dev

📚 Documentation

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

  1. Restart Claude Desktop after configuration
  2. Check the config file location is correct for your OS
  3. Ensure alecs command works in terminal first

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes with tests
  4. Run npm test and npm run typecheck
  5. Submit a pull request

📄 License

GNU Affero General Public License v3.0 (AGPL-3.0) with additional terms - see LICENSE 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 CONTRIBUTING.md for contribution requirements

🆘 Support

Built with ❤️ for the Akamai and AI communities

Trigger CI/CD

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

How are these scores calculated?

hybrid server

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

Tools

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. 📊 Latest Release Docs
    1. 🚀 Quick Start
      1. Install from NPM
      2. Configure Akamai Credentials
      3. Add to Claude Desktop
      4. Add to Claude Code
      5. Install from Source
      6. Docker
    2. 📖 Integration Guide
      1. Quick Reference
      2. Detailed Setup Instructions
    3. 🤝 Works With Your Favorite AI Tools
      1. 🎆 Natural Language, Real Actions
    4. 🏆 Stats & Features
      1. 🌟 Supported Akamai Services
    5. 📋 Overview
      1. 🚀 Key Features
    6. 🏗️ Architecture
      1. 🛠️ Available Tools
        1. Property Management
        2. DNS Management
        3. Certificate Management
        4. Content Control
      2. 🔧 Installation
        1. For Claude Desktop
        2. For Development
      3. 📚 Documentation
        1. 🧪 Testing
          1. 🔒 Security
            1. ⚠️ Important Security Note
          2. 🔧 Troubleshooting
            1. Common Setup Issues
          3. 🤝 Contributing
            1. 📄 License
              1. 🆘 Support
                1. Trigger CI/CD

                  Related MCP Servers

                  • ACI MCP Server

                    aipotheosis-labs
                    -
                    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 -
                    217
                    Python
                    MIT License
                    • Apple

                  • MCPfinder Server

                    mcpfinder
                    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
                    209
                    3
                    JavaScript
                    AGPL 3.0
                    • Linux
                    • Apple

                  • Rini MCP Server

                    mori-mmmm
                    -
                    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

                  • MCP Location Server

                    869413421
                    -
                    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 -
                    1
                    Python
                    • Linux
                    • Apple

                  View all related MCP servers

                  New 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/acedergren/alecs-mcp-server-akamai'

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