akamai-docs-mcp

一个本地 MCP 服务器，基于 Akamai TechDocs，范围限定为 CDN、安全、DNS 和 EdgeWorkers（有意排除 Akamai Cloud —— 请使用官方的 akamai-cloud-mcp 来处理）。

文档从 Akamai 自己的 llms.txt 索引中拉取（每个产品的 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 中列出的每个 slug 下载页面（目前：CDN 的 property-mgr、purge、adaptive-media-delivery；安全的 application-security、network-lists；DNS 的 edge-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

尝试使用类似 "activate a security configuration version" 或 "edgeworkers subworker limits" 的内容调用 search_akamai_docs。

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()

调整范围

编辑 config.py 中的 PRODUCT_SCOPE，按类别添加/删除产品 slug。要查找 slug，请访问该产品的任何 TechDocs 页面，并查看顶部的“For AI agents”行，该行指向 .../<slug>/llms.txt。

备注

• 搜索是 BM25 关键词搜索（rank_bm25）—— 没有嵌入，查询时没有外部 API 调用。对于 PoC/演示来说足够好；如果以后在释义查询上出现召回问题，可以换成向量存储。

• 此服务器是只读且仅限文档的。对于实时账户/API 访问（属性、DNS 区域、安全配置、EdgeWorkers 部署），请与 Akamai 官方的 MCP 服务器配合使用，而不是扩展此服务器。