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에 나열된 모든 slug의 페이지를 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"]
    }
  }
}

클라이언트를 다시 시작하면 다음 세 가지 도구를 사용할 수 있습니다:

• 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 액세스(properties, DNS 영역, 보안 구성, EdgeWorkers 배포)가 필요하면 이 서버를 확장하는 대신 Akamai 공식 MCP 서버와 함께 사용하세요.