akamai-docs-mcp

Ein lokaler MCP-Server über Akamai TechDocs, beschränkt auf CDN, Security, DNS und EdgeWorkers (Akamai Cloud ist bewusst ausgeschlossen – verwenden Sie dafür den offiziellen akamai-cloud-mcp).

Die Dokumentation wird aus Akamais eigenen llms.txt-Indizes abgerufen (Markdown-formatierte Seitenlisten pro Produkt), sodass kein HTML-Scraping erforderlich ist.

1. Installation

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

Related MCP server: mcp-docs

2. Dokumentation erfassen

python ingest.py

Dies lädt Seiten für jeden in config.py aufgeführten Slug herunter (derzeit: property-mgr, purge, adaptive-media-delivery für CDN; application-security, network-lists für Security; edge-dns für DNS; edgeworkers für EdgeWorkers) in docs_corpus/.

Nützliche Flags:

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

Führen Sie ingest.py jederzeit erneut aus, um den Korpus zu aktualisieren – es überschreibt vorhandene Dateien.

3. Server lokal testen

npx @modelcontextprotocol/inspector python server.py

Versuchen Sie, search_akamai_docs mit etwas wie "activate a security configuration version" oder "edgeworkers subworker limits" aufzurufen.

4. In Claude Desktop / Claude Code einbinden

Fügen Sie es zu Ihrer MCP-Client-Konfiguration hinzu (z. B. claude_desktop_config.json):

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

Starten Sie den Client neu. Sie sollten drei Tools verfügbar sehen:

• search_akamai_docs(query, category?, top_k?)

• get_full_doc(path)

• list_categories()

Umfang anpassen

Bearbeiten Sie PRODUCT_SCOPE in config.py, um Produkt-Slugs pro Kategorie hinzuzufügen/zu entfernen. Finden Sie einen Slug, indem Sie eine beliebige TechDocs-Seite für dieses Produkt besuchen und die Zeile „Für KI-Agenten" oben ansehen, die auf .../<slug>/llms.txt verweist.

Hinweise

• Die Suche ist eine BM25-Keyword-Suche (rank_bm25) – keine Embeddings, keine externen API-Aufrufe zur Abfragezeit. Für ein PoC/Demo ausreichend; tauschen Sie später einen Vektor-Store ein, falls die Trefferquote bei paraphrasierten Abfragen zum Problem wird.

• Dieser Server ist schreibgeschützt und nur für Dokumentation. Für Live-Konto-/API-Zugriff (Properties, DNS-Zonen, Sicherheitskonfigurationen, EdgeWorkers-Bereitstellungen) kombinieren Sie ihn mit den offiziellen MCP-Servern von Akamai, anstatt diesen zu erweitern.