English Français العربية

Akamai CDN

السجل الرسمي البحث والويب

Read-only MCP server for Akamai CDN — properties, EdgeWorkers, DNS, network lists

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package readonly-mcp-akamai
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
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "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>"
            }
        }
    }
}

متغيرات البيئة

  • AKAMAI_HOST إلزامي Akamai EdgeGrid API hostname (e.g., akab-xxxx.luna.akamaiapis.net)
  • AKAMAI_CLIENT_TOKEN إلزامي سري Akamai EdgeGrid client token
  • AKAMAI_CLIENT_SECRET إلزامي سري Akamai EdgeGrid client secret
  • AKAMAI_ACCESS_TOKEN إلزامي سري Akamai EdgeGrid access token

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. readonly-mcp-akamai
  2. Tools
  3. Install
  4. Docker
  5. Configuration
  6. MCP client configuration
  7. Example questions
  8. Development
  9. License

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)
ToolDescription
search_propertiesFuzzy search CDN properties by name. Uses a preloaded in-memory index refreshed every 5 minutes.
get_property_detailsGet property versions, hostnames, and activation status.
get_property_rulesGet the rule tree for a property version — the full CDN configuration.
get_property_activationsList deployment history for a property.
DNS
ToolDescription
list_dns_zonesList all DNS zones, optionally filtered by name or type.
search_dns_recordsSearch DNS records within a zone by name or record type.
EdgeWorkers (serverless functions)
ToolDescription
list_edgeworkersList all EdgeWorker IDs with names and descriptions.
list_edgeworker_versionsList versions for an EdgeWorker.
get_edgeworker_filesDownload a version's code bundle and list all files. Cached in memory.
get_edgeworker_fileRead a specific file from a cached bundle with line-range support.
search_edgeworker_codeRegex search across all files in a cached bundle.
Network Lists
ToolDescription
search_network_listsSearch network lists (IP allowlists, blocklists, geo lists) by name.
get_network_listGet the full contents of a network list.
Utility
ToolDescription
list_groupsList account groups in the Akamai hierarchy.
list_cp_codesList CP codes (billing/reporting identifiers) for a contract and group.
translate_error_codeTranslate 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.

VariableRequiredDefaultDescription
AKAMAI_HOSTYes—Akamai API hostname (e.g., akab-xxxx.luna.akamaiapis.net)
AKAMAI_CLIENT_TOKENYes—EdgeGrid client token
AKAMAI_CLIENT_SECRETYes—EdgeGrid client secret
AKAMAI_ACCESS_TOKENYes—EdgeGrid access token
AKAMAI_TRANSPORTNostdioTransport: stdio, http, or sse
AKAMAI_HTTP_PORTNo8080Port for HTTP/SSE transport
AKAMAI_LOG_FORMATNojsonLog format: json or text
AKAMAI_LOG_LEVELNoINFOLog level: DEBUG, INFO, WARNING, ERROR
AKAMAI_INDEX_REFRESH_INTERVALNo300Property 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 setResponseHeader in 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

الأسئلة الشائعة

ما هو Akamai CDN؟

Read-only MCP server for Akamai CDN — properties, EdgeWorkers, DNS, network lists

كيف أثبّت Akamai CDN؟

يعمل على جهازك. في 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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Akamai CDN إلى مفتاح API؟

نعم. يتطلب AKAMAI_HOST, AKAMAI_CLIENT_TOKEN, AKAMAI_CLIENT_SECRET, AKAMAI_ACCESS_TOKEN، وتضبطها في إعداداته.

هل Akamai CDN مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Akamai CDN؟

ينشره desty2k. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.