Akamai CDN
Read-only MCP server for Akamai CDN — properties, EdgeWorkers, DNS, network lists
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
readonly-mcp-akamaiclaude mcp add akamai-cdn -e 'AKAMAI_HOST=<AKAMAI_HOST>' -e 'AKAMAI_CLIENT_TOKEN=<your akamai_client_token>' -e 'AKAMAI_CLIENT_SECRET=<your akamai_client_secret>' -e 'AKAMAI_ACCESS_TOKEN=<your akamai_access_token>' -- uvx readonly-mcp-akamai==0.1.1
{
"mcpServers": {
"akamai-cdn": {
"command": "uvx",
"args": [
"readonly-mcp-akamai==0.1.1"
],
"env": {
"AKAMAI_HOST": "<AKAMAI_HOST>",
"AKAMAI_CLIENT_TOKEN": "<your akamai_client_token>",
"AKAMAI_CLIENT_SECRET": "<your akamai_client_secret>",
"AKAMAI_ACCESS_TOKEN": "<your akamai_access_token>"
}
}
}
}
Variables d'environnement
AKAMAI_HOSTobligatoire Akamai EdgeGrid API hostname (e.g., akab-xxxx.luna.akamaiapis.net)AKAMAI_CLIENT_TOKENobligatoire secret Akamai EdgeGrid client tokenAKAMAI_CLIENT_SECRETobligatoire secret Akamai EdgeGrid client secretAKAMAI_ACCESS_TOKENobligatoire secret Akamai EdgeGrid access token
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
readonly-mcp-akamai
Read-only MCP server for Akamai CDN. Search properties, browse EdgeWorker code, query DNS zones, inspect network lists, and translate error codes.
Read-only by design. This server can only read data. It cannot create, modify, delete, activate, deactivate, or purge anything. See blog.wentland.io for the rationale.
Tools
Properties (CDN configurations)
| Tool | Description |
|---|---|
search_properties | Fuzzy search CDN properties by name. Uses a preloaded in-memory index refreshed every 5 minutes. |
get_property_details | Get property versions, hostnames, and activation status. |
get_property_rules | Get the rule tree for a property version — the full CDN configuration. |
get_property_activations | List deployment history for a property. |
DNS
| Tool | Description |
|---|---|
list_dns_zones | List all DNS zones, optionally filtered by name or type. |
search_dns_records | Search DNS records within a zone by name or record type. |
EdgeWorkers (serverless functions)
| Tool | Description |
|---|---|
list_edgeworkers | List all EdgeWorker IDs with names and descriptions. |
list_edgeworker_versions | List versions for an EdgeWorker. |
get_edgeworker_files | Download a version's code bundle and list all files. Cached in memory. |
get_edgeworker_file | Read a specific file from a cached bundle with line-range support. |
search_edgeworker_code | Regex search across all files in a cached bundle. |
Network Lists
| Tool | Description |
|---|---|
search_network_lists | Search network lists (IP allowlists, blocklists, geo lists) by name. |
get_network_list | Get the full contents of a network list. |
Utility
| Tool | Description |
|---|---|
list_groups | List account groups in the Akamai hierarchy. |
list_cp_codes | List CP codes (billing/reporting identifiers) for a contract and group. |
translate_error_code | Translate Akamai reference error codes to human-readable descriptions. |
Install
# With uv (recommended)
uv pip install readonly-mcp-akamai
# With pip
pip install readonly-mcp-akamai
Docker
docker run -e AKAMAI_HOST=... -e AKAMAI_CLIENT_TOKEN=... \
-e AKAMAI_CLIENT_SECRET=... -e AKAMAI_ACCESS_TOKEN=... \
ghcr.io/desty2k/readonly-mcp-akamai
Configuration
All settings are via environment variables with the AKAMAI_ prefix.
| Variable | Required | Default | Description |
|---|---|---|---|
AKAMAI_HOST | Yes | — | Akamai API hostname (e.g., akab-xxxx.luna.akamaiapis.net) |
AKAMAI_CLIENT_TOKEN | Yes | — | EdgeGrid client token |
AKAMAI_CLIENT_SECRET | Yes | — | EdgeGrid client secret |
AKAMAI_ACCESS_TOKEN | Yes | — | EdgeGrid access token |
AKAMAI_TRANSPORT | No | stdio | Transport: stdio, http, or sse |
AKAMAI_HTTP_PORT | No | 8080 | Port for HTTP/SSE transport |
AKAMAI_LOG_FORMAT | No | json | Log format: json or text |
AKAMAI_LOG_LEVEL | No | INFO | Log level: DEBUG, INFO, WARNING, ERROR |
AKAMAI_INDEX_REFRESH_INTERVAL | No | 300 | Property index refresh interval in seconds |
Get credentials from Akamai Control Center > Identity & Access Management > API Clients.
MCP client configuration
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"akamai": {
"command": "readonly-mcp-akamai",
"env": {
"AKAMAI_HOST": "akab-xxxx.luna.akamaiapis.net",
"AKAMAI_CLIENT_TOKEN": "akab-xxxx",
"AKAMAI_CLIENT_SECRET": "xxxx",
"AKAMAI_ACCESS_TOKEN": "akab-xxxx"
}
}
}
}
Claude Code
claude mcp add akamai -- readonly-mcp-akamai
Set the AKAMAI_* environment variables before starting Claude Code.
Example questions
An agent with this server can answer:
- "Find the CDN property for api.example.com and show me its caching rules"
- "What version is currently deployed to production for the main website?"
- "Show me all DNS records for example.com"
- "What EdgeWorkers are configured? Show me the code for the request router"
- "Search for all uses of
setResponseHeaderin EdgeWorker 42" - "What IPs are in the blocklist network list?"
- "Translate this Akamai error: 9.6f64d440.1318965461.2f2b078"
- "List all CP codes for the main contract"
Development
# Clone
git clone https://github.com/desty2k/readonly-mcp-akamai.git
cd readonly-mcp-akamai
# Install with dev dependencies
uv pip install -e ".[dev]"
# Run tests
pytest --cov
# Lint
ruff check .
ruff format --check .
License
MIT
Questions fréquentes
Qu'est-ce que Akamai CDN ?
Read-only MCP server for Akamai CDN — properties, EdgeWorkers, DNS, network lists
Comment installer Akamai CDN ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add akamai-cdn -e 'AKAMAI_HOST=<AKAMAI_HOST>' -e 'AKAMAI_CLIENT_TOKEN=<your akamai_client_token>' -e 'AKAMAI_CLIENT_SECRET=<your akamai_client_secret>' -e 'AKAMAI_ACCESS_TOKEN=<your akamai_access_token>' -- uvx readonly-mcp-akamai==0.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour Akamai CDN ?
Oui. Il attend AKAMAI_HOST, AKAMAI_CLIENT_TOKEN, AKAMAI_CLIENT_SECRET, AKAMAI_ACCESS_TOKEN, à renseigner dans sa configuration.
Akamai CDN est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient Akamai CDN ?
Il est publié par desty2k. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.