akamai-docs-mcp

Un servidor MCP local sobre Akamai TechDocs, centrado en CDN, Security, DNS y EdgeWorkers (Akamai Cloud se excluye a propósito: use el akamai-cloud-mcp oficial para eso).

Los documentos se obtienen de los propios índices llms.txt de Akamai (listas de páginas en formato Markdown por producto), por lo que no se realiza scraping de HTML.

1. Instalación

python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt

Related MCP server: mcp-docs

2. Ingesta de los documentos

python ingest.py

Esto descarga páginas para cada slug listado en config.py (actualmente: property-mgr, purge, adaptive-media-delivery para CDN; application-security, network-lists para Security; edge-dns para DNS; edgeworkers para EdgeWorkers) en docs_corpus/.

Opciones útiles:

python ingest.py --categories dns edgeworkers   # only ingest a subset
python ingest.py --limit-per-slug 15            # quick test run, few pages per slug

Vuelva a ejecutar ingest.py en cualquier momento para refrescar el corpus: sobrescribe los archivos existentes.

3. Pruebe el servidor localmente

npx @modelcontextprotocol/inspector python server.py

Pruebe a llamar a search_akamai_docs con algo como "activate a security configuration version" o "edgeworkers subworker limits".

4. Conéctelo a Claude Desktop / Claude Code

Añada a la configuración de su cliente MCP (p. ej. claude_desktop_config.json):

{
  "mcpServers": {
    "akamai-docs": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": ["/absolute/path/to/akamai-docs-mcp/server.py"]
    }
  }
}

Reinicie el cliente. Debería ver tres herramientas disponibles:

• search_akamai_docs(query, category?, top_k?)

• get_full_doc(path)

• list_categories()

Ajuste del ámbito

Edite PRODUCT_SCOPE en config.py para añadir/quitar slugs de producto por categoría. Encuentre un slug visitando cualquier página de TechDocs para ese producto y consultando la línea "Para agentes de IA" de la parte superior, que apunta a .../<slug>/llms.txt.

Notas

• La búsqueda es de palabras clave BM25 (rank_bm25): sin embeddings, sin llamadas externas a la API en el momento de la consulta. Suficiente para una PoC/demo; sustituya por un almacén vectorial más adelante si la recuperación se convierte en un problema con consultas parafraseadas.

• Este servidor es de solo lectura y solo de documentos. Para acceso en vivo a cuentas/API (propiedades, zonas DNS, configuraciones de seguridad, despliegues de EdgeWorkers), combínelo con los servidores MCP oficiales de Akamai en lugar de ampliar este.