Akamai CDN

io.github.desty2k由 GitHub 帳號 desty2k 發布v0.2.1更新於 Nov 10, 2026

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

概覽

AI 產生的概覽

唯讀的 MCP 伺服器,讓助理檢視 Akamai CDN 帳戶:屬性設定、EdgeWorkers、Edge DNS、網路清單與 CP 代碼。

可以做什麼
  • 搜尋並檢視 CDN 屬性:依名稱模糊搜尋、版本、主機名稱、啟用狀態、規則樹與部署歷程
  • 列出 DNS 區域,並依名稱或記錄類型在區域內搜尋記錄
  • 列出 EdgeWorker 與版本,下載某版本的程式碼包,讀取個別檔案並在程式碼包內以正規表達式搜尋
  • 搜尋網路清單並讀取其項目,例如 IP 允許清單與封鎖清單
  • 列出帳戶群組與 CP 代碼,並將 Akamai 錯誤參考碼轉成易懂的說明
適用情境
適合在不開啟 Control Center 的情況下回答關於現有 Akamai 設定的問題,例如某個主機名稱由哪個屬性提供、套用了哪些快取規則、正式環境部署了哪個版本、有哪些 DNS 記錄,或某個 EdgeWorker 執行什麼程式碼。
執行需求
以本機 Python 套件形式執行(需 Python 3.11 或更新版本),可透過 uvx、pip 或 Docker 啟動,預設使用 stdio 傳輸。需要一個 Akamai API 用戶端與四個環境變數:AKAMAI_HOST、AKAMAI_CLIENT_TOKEN、AKAMAI_CLIENT_SECRET、AKAMAI_ACCESS_TOKEN。該 API 用戶端需具備 Property Manager、Edge DNS、EdgeWorkers、Network Lists 與 Edge Diagnostics 的存取權限。
安裝前請注意
需要 Akamai EdgeGrid 憑證(AKAMAI_CLIENT_SECRET、AKAMAI_ACCESS_TOKEN、AKAMAI_CLIENT_TOKEN),可讀取帳戶資料,建議只授予唯讀權限作為額外防護。選用的 http 與 sse 傳輸沒有身分驗證,任何能連上該連接埠的人都能讀取帳戶;Docker 映像預設監聽所有網路介面。所有工具皆為讀取操作,伺服器無法建立、修改、刪除、啟用或清除任何內容。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Akamai CDN,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

readonly-mcp-akamai

[CI] [codecov] [PyPI] [Python] [License: MIT]

A read-only Model Context Protocol (MCP) server that lets AI agents explore an Akamai account: CDN properties and their rule trees, EdgeWorker code, Edge DNS zones, network lists, CP codes, and error references. 16 tools, all of them reads.

Quick start

With uv installed, there is nothing else to install:

bash
claude mcp add akamai \  -e AKAMAI_HOST=akab-xxxx.luna.akamaiapis.net \  -e AKAMAI_CLIENT_TOKEN=akab-xxxx \  -e AKAMAI_CLIENT_SECRET=xxxx \  -e AKAMAI_ACCESS_TOKEN=akab-xxxx \  -- uvx readonly-mcp-akamai

uvx downloads the package into a cached, isolated environment and runs it. Python 3.11 or newer.

Read-only by design. Every call this server makes reads. It uses GET, plus one POST to Akamai's error translator, which takes an error reference and returns what it means without changing anything. The client refuses a POST to any other path before sending it, and a test checks that. It cannot create, modify, delete, activate, deactivate, or purge anything. Give the API client read-only access as a second line of defense: see Credentials. Read the post about this server and why I build read-only MCP servers.

Credentials

Create an API client in Akamai Control Center under Identity & Access Management → API clients. Grant read-only access, where the API offers it, to the APIs the tools use:

APIUsed by
Property Manager (PAPI)properties, groups, CP codes
Edge DNSDNS tools
EdgeWorkersEdgeWorker tools
Network Listsnetwork list tools
Edge Diagnosticstranslate_error_code

The client's host, client_token, client_secret and access_token map to the four AKAMAI_* variables below.

Tools

Properties (CDN configurations)

ToolDescription
search_propertiesFuzzy search CDN properties by name. Uses a preloaded in-memory index refreshed every 5 minutes. Returns match scores, flags close matches, and reports why the index failed to load if it did.
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. Returns at most 500 records.

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 (bundles up to 16 MB, 128 MB in total).
get_edgeworker_fileRead a specific file from a cached bundle with line-range support. Output is capped at 100,000 characters, with the line to continue from.
search_edgeworker_codeRegex search across all files in a cached bundle. Returns at most 200 matches.

Network Lists

ToolDescription
search_network_listsSearch network lists (IP allowlists, blocklists, geo lists) by name.
get_network_listGet the contents of a network list, at most 5,000 entries.

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

bash
uv tool install readonly-mcp-akamai   # or: pip install readonly-mcp-akamai

Not needed for the Quick start, which runs it with uvx.

Docker

bash
docker run -i --rm \  -e AKAMAI_HOST=akab-xxxx.luna.akamaiapis.net \  -e AKAMAI_CLIENT_TOKEN=akab-xxxx \  -e AKAMAI_CLIENT_SECRET=xxxx \  -e AKAMAI_ACCESS_TOKEN=akab-xxxx \  ghcr.io/desty2k/readonly-mcp-akamai:latest

-i keeps stdin open for the default stdio transport.

Configuration

All settings are 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_HOSTNo127.0.0.1Address the HTTP/SSE transport listens on
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

The http and sse transports have no authentication: anyone who can reach the port can read the Akamai account with the configured credentials. They listen on 127.0.0.1 by default. Setting AKAMAI_HTTP_HOST to any other address logs a warning at startup. The Docker image sets AKAMAI_HTTP_HOST=0.0.0.0 so a published port works; publish it on loopback only:

bash
docker run --rm -p 127.0.0.1:8080:8080 -e AKAMAI_TRANSPORT=http \  -e AKAMAI_HOST=... -e AKAMAI_CLIENT_TOKEN=... \  -e AKAMAI_CLIENT_SECRET=... -e AKAMAI_ACCESS_TOKEN=... \  ghcr.io/desty2k/readonly-mcp-akamai:latest

MCP client configuration

Claude Desktop

Add to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):

json
{  "mcpServers": {    "akamai": {      "command": "uvx",      "args": ["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

See Quick start.

How it compares

As of November 2026. Akamai's own MCP servers under akamai-developers cover other products: Akamai Cloud (Linode, also read-only), Akamai Functions, and the documentation. None of them reads Property Manager, EdgeWorkers, Edge DNS, or Network Lists. Check the projects themselves before relying on this.

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

bash
git clone https://github.com/desty2k/readonly-mcp-akamaicd readonly-mcp-akamaiuv sync --extra devuv run pytest --covuv run ruff check .uv run ruff format --check .

License

MIT — see LICENSE.

來源:README.md,提交 ed1bff1

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

2
  1. v0.2.1最新Nov 3, 2026
  2. v0.1.1Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分