akamai-docs-mcp

Akamai TechDocs 上のローカル MCP サーバーで、CDN、Security、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 にリストされているすべてのスラッグのページが docs_corpus/ にダウンロードされます（現在: CDN 用の property-mgr、purge、adaptive-media-delivery、Security 用の application-security、network-lists、DNS 用の edge-dns、EdgeWorkers 用の edgeworkers）。

便利なフラグ:

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"]
    }
  }
}

クライアントを再起動します。次の 3 つのツールが利用可能になるはずです:

• search_akamai_docs(query, category?, top_k?)

• get_full_doc(path)

• list_categories()

スコープの調整

config.py の PRODUCT_SCOPE を編集して、カテゴリごとに製品スラッグを追加/削除します。スラッグを見つけるには、その製品の TechDocs ページにアクセスし、上部の「For AI agents」行を確認します。その行は .../<slug>/llms.txt を指しています。

メモ

• 検索は BM25 キーワード検索（rank_bm25）です — 埋め込みやクエリ時の外部 API 呼び出しはありません。PoC/デモには十分です。言い換えクエリで再現性が問題になる場合は、後でベクターストアに置き換えてください。

• このサーバーは読み取り専用でドキュメント専用です。ライブのアカウント/API アクセス（プロパティ、DNS ゾーン、セキュリティ設定、EdgeWorkers デプロイメント）には、これを拡張するのではなく、Akamai の公式 MCP サーバーと組み合わせて使用してください。