akamai-docs-mcp

Локальный MCP-сервер для Akamai TechDocs, ограниченный CDN, Security, DNS и EdgeWorkers (Akamai Cloud намеренно исключён — для этого используйте официальный akamai-cloud-mcp).

Документация загружается из собственных индексов llms.txt Akamai (списки страниц в формате Markdown для каждого продукта), поэтому HTML-скрапинг не используется.

1. Установка

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

Related MCP server: mcp-docs

2. Загрузка документации

python ingest.py

Эта команда загружает страницы для каждого слага, указанного в config.py (в настоящее время: property-mgr, purge, adaptive-media-delivery для CDN; application-security, network-lists для Security; edge-dns для DNS; edgeworkers для EdgeWorkers) в каталог docs_corpus/.

Полезные флаги:

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

Повторно запускайте ingest.py в любое время для обновления корпуса — он перезаписывает существующие файлы.

3. Локальное тестирование сервера

npx @modelcontextprotocol/inspector python server.py

Попробуйте вызвать search_akamai_docs с чем-то вроде "activate a security configuration version" или "edgeworkers subworker limits".

4. Подключение к Claude Desktop / Claude Code

Добавьте в конфигурацию вашего MCP-клиента (например, claude_desktop_config.json):

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

Перезапустите клиент. Вы должны увидеть три доступных инструмента:

• search_akamai_docs(query, category?, top_k?)

• get_full_doc(path)

• list_categories()

Настройка области охвата

Отредактируйте PRODUCT_SCOPE в config.py, чтобы добавить/удалить слаги продуктов по категориям. Найдите слаг, посетив любую страницу TechDocs для этого продукта и посмотрев на строку "For AI agents" вверху, которая указывает на .../<slug>/llms.txt.

Примечания

• Поиск — это BM25-ключевой поиск (rank_bm25) — без эмбеддингов и внешних API-вызовов во время запроса. Этого достаточно для PoC/демо; позже можно заменить на векторное хранилище, если recall станет проблемой для перефразированных запросов.

• Этот сервер только для чтения и только для документации. Для живого доступа к аккаунту/API (свойства, DNS-зоны, конфигурации безопасности, развёртывания EdgeWorkers) используйте официальные MCP-серверы Akamai, а не расширяйте этот.