mcp-connector-for-akamai

Disclaimer: This is an independent, unofficial, community-driven project. It is not affiliated with, endorsed by, sponsored by, or in any way officially connected to Akamai Technologies, Inc. The name "Akamai" and any related trademarks, service marks, or logos are the property of their respective owners and are used here solely for descriptive purposes to indicate compatibility. Use of these names does not imply any affiliation or endorsement. This software is provided "as is", without warranty of any kind. The authors assume no liability for any damages arising from the use of this software.

An unofficial MCP (Model Context Protocol) server that connects AI assistants to Akamai APIs. Provides tools for edge diagnostics, debugging, and network analysis.

Link to NPM: https://npmjs.com/package/mcp-connector-for-akamai

Tools

Edge Diagnostics

Setup

Prerequisites

• Node.js 18+ or Bun
• Akamai API credentials with Edge Diagnostics API access

Build

bun install
bun run build

Environment Variables

VS Code / Copilot Configuration

Add to your .vscode/mcp.json:

{
  "inputs": [
    { "id": "akamai-client-secret", "type": "promptString", "description": "Akamai EdgeGrid client secret", "password": true },
    { "id": "akamai-client-token", "type": "promptString", "description": "Akamai EdgeGrid client token", "password": true },
    { "id": "akamai-access-token", "type": "promptString", "description": "Akamai EdgeGrid access token", "password": true },
    { "id": "akamai-host", "type": "promptString", "description": "Akamai API hostname (e.g. akab-xxx.luna.akamaiapis.net)" }
  ],
  "servers": {
    "mcp-connector-for-akamai": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-connector-for-akamai"],
      "env": {
        "AKAMAI_CLIENT_SECRET": "${input:akamai-client-secret}",
        "AKAMAI_CLIENT_TOKEN": "${input:akamai-client-token}",
        "AKAMAI_ACCESS_TOKEN": "${input:akamai-access-token}",
        "AKAMAI_HOST": "${input:akamai-host}"
      }
    }
  }
}

Claude Desktop Configuration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-connector-for-akamai": {
      "command": "npx",
      "args": ["-y", "mcp-connector-for-akamai"],
      "env": {
        "AKAMAI_CLIENT_SECRET": "...",
        "AKAMAI_CLIENT_TOKEN": "...",
        "AKAMAI_ACCESS_TOKEN": "...",
        "AKAMAI_HOST": "..."
      }
    }
  }
}

Development

Adding new API tools

1. Generate the API client: add the OpenAPI spec URL to generate-clients.sh (in the parent workspace) and run it
2. Create a wrapper in src/akamai/apis/<api-name>/
3. Add tool registration files under src/tools/<api-name>/
4. Register the tools in src/tools/index.ts

Project structure

src/
├── index.ts                          # Entry point (McpServer + STDIO transport)
├── akamai/
│   ├── client.ts                     # Namespaced client hub (edgeDiagnostics, future APIs)
│   ├── customFetch.ts                # EdgeGrid-authenticated fetch
│   ├── generateAkamaiToken.ts        # EdgeGrid auth token generation
│   └── apis/
│       └── edge-diagnostics/
│           ├── index.ts              # Client factory & re-exports
│           └── v1/                   # Auto-generated API client
└── tools/
    ├── index.ts                      # Tool registration hub
    ├── utils.ts                      # Polling, formatting helpers
    └── edge-diagnostics/             # One file per tool or tool group