Akamai CDN

readonly-mcp-akamai

Akamai CDN 用の読み取り専用 MCP サーバーです。プロパティの検索、EdgeWorker コードの閲覧、DNS ゾーンの照会、ネットワークリストの確認、エラーコードの変換ができます。

読み取り専用設計です。 このサーバーでできるのはデータの読み取りのみです。作成、変更、削除、有効化、無効化、パージはできません。理由については blog.wentland.io をご覧ください。

ツール

プロパティ（CDN 設定）

ツール	説明
search_properties	CDN プロパティを名前であいまい検索します。5 分ごとに更新される、事前読み込み済みのインメモリーインデックスを使用します。
get_property_details	プロパティのバージョン、ホスト名、有効化ステータスを取得します。
get_property_rules	プロパティのバージョンに対応するルールツリー（CDN 設定全体）を取得します。
get_property_activations	プロパティのデプロイ履歴を一覧表示します。

DNS

ツール	説明
list_dns_zones	すべての DNS ゾーンを一覧表示します。名前または種類で絞り込むこともできます。
search_dns_records	ゾーン内の DNS レコードを、名前またはレコードタイプで検索します。

EdgeWorkers（サーバーレス関数）

ツール	説明
list_edgeworkers	すべての EdgeWorker ID を名前と説明とともに一覧表示します。
list_edgeworker_versions	EdgeWorker のバージョンを一覧表示します。
get_edgeworker_files	バージョンのコードバンドルをダウンロードし、すべてのファイルを一覧表示します。メモリーにキャッシュされます。
get_edgeworker_file	キャッシュされたバンドルから特定のファイルを読み取ります。行範囲を指定できます。
search_edgeworker_code	キャッシュされたバンドル内のすべてのファイルを正規表現で検索します。

ネットワークリスト

ツール	説明
search_network_lists	ネットワークリスト（IP 許可リスト、ブロックリスト、地理リスト）を名前で検索します。
get_network_list	ネットワークリストの全内容を取得します。

ユーティリティ

ツール	説明
list_groups	Akamai の階層内にあるアカウントグループを一覧表示します。
list_cp_codes	契約とグループに対応する CP コード（課金／レポート用識別子）を一覧表示します。
translate_error_code	Akamai の参照エラーコードを、人が読みやすい説明に変換します。

インストール

# 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

設定

すべての設定は、AKAMAI_ プレフィックスが付いた環境変数で行います。

変数	必須	デフォルト	説明
AKAMAI_HOST	はい	—	Akamai API のホスト名（例：akab-xxxx.luna.akamaiapis.net）
AKAMAI_CLIENT_TOKEN	はい	—	EdgeGrid クライアントトークン
AKAMAI_CLIENT_SECRET	はい	—	EdgeGrid クライアントシークレット
AKAMAI_ACCESS_TOKEN	はい	—	EdgeGrid アクセストークン
AKAMAI_TRANSPORT	いいえ	stdio	トランスポート：stdio、http、または sse
AKAMAI_HTTP_PORT	いいえ	8080	HTTP／SSE トランスポート用のポート
AKAMAI_LOG_FORMAT	いいえ	json	ログ形式：json または text
AKAMAI_LOG_LEVEL	いいえ	INFO	ログレベル：DEBUG、INFO、WARNING、ERROR
AKAMAI_INDEX_REFRESH_INTERVAL	いいえ	300	プロパティインデックスの更新間隔（秒）

認証情報は、Akamai Control Center > Identity & Access Management > API Clients から取得してください。

MCP クライアントの設定

Claude Desktop

~/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

Claude Code を起動する前に、AKAMAI_* 環境変数を設定してください。

質問例

このサーバーを利用するエージェントは、次のような質問に回答できます。

• 「api.example.com の CDN プロパティを探して、キャッシュルールを見せてください」
• 「メインのウェブサイトで現在本番環境にデプロイされているバージョンは何ですか？」
• 「example.com のすべての DNS レコードを見せてください」
• 「どの EdgeWorkers が設定されていますか？リクエストルーターのコードを見せてください」
• 「EdgeWorker 42 での setResponseHeader の使用箇所をすべて検索してください」
• 「ブロックリストのネットワークリストにはどの IP が含まれていますか？」
• 「この Akamai エラーを翻訳してください：9.6f64d440.1318965461.2f2b078」
• 「メイン契約のすべての CP コードを一覧表示してください」

開発

# 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 .

ライセンス

MIT