justin
fa448f94e1
Initial scaffold: the docs-mcp-template clone with all the
HVM-validated stack ported across, customized for Morpheus
Enterprise (PRODUCT_NAME=morpheus, server name morpheus-docs).
Bundles (live-discovered 2026-05-22; 1710 cataloged pages total):
* morpheus_user_manual_8_1_0 sd00007510en_us 568 pages (Feb 2026)
* morpheus_user_manual_8_1_1 sd00007621en_us 569 pages (Mar 2026)
* morpheus_user_manual_8_1_2 sd00007732en_us 569 pages (Apr 2026)
* morpheus_release_notes_8_1_0 sd00007496en_us single-doc
* morpheus_release_notes_8_1_1 sd00007610en_us single-doc
* morpheus_release_notes_8_1_2 sd00007733en_us single-doc
* morpheus_quickspecs a50009231enw html-file (live
curl_cffi against www.hpe.com; all 12+ Enterprise SKUs captured —
S6E64..S6E73AAE for new/renewal/upgrade × 1/3/5-yr terms, plus
services SKUs HA124A1#V38/V39 and H46SBA1).
No Deployment Guide or Qualification Matrix on HPE Support for
Morpheus Enterprise specifically — the only QM (sd00006551en_us)
covers HVM clusters managed by Morpheus and lives in hvm-docs.
Stack carried forward from hvm-docs:
* rag/{index,chunk,embeddings,bm25}.py — including the
MAX_CHARS=4000 chunk-cap fix for table-dense content
* docs_mcp/{server,usage}.py — 11 MCP tools, BM25-default search,
cross-encoder rerank, hybrid behind HYBRID_SEARCH=true,
morpheus_api_lessons (renamed from hvm_api_lessons), env-gated
submit_doc_bug
* docs_mcp/api_lessons.md — Morpheus-specific scaffold covering
licensing model, HVM elevation path, REST vs Plugin API, with
TODO markers for sections to flesh out from real ops experience
* scrape/{runner,quickspecs,changelog,bundles}.py — TOC + single-doc
+ html-file modes, curl_cffi Chrome120 for www.hpe.com edge bypass
* eval/{retrievers,run_eval}.py + queries.jsonl scaffold (4 placeholder
queries; populate after first scrape)
* scripts/{rerank_server,usage_report,registry_gc}.py
* .gitea/workflows/{refresh,image-only}.yml — same Gitea Actions
setup zerto-docs uses (push LAN, pull public-URL, GPU Ollama pool)
* deploy/docker-compose.yml — morpheus-docs-mcp service definition,
shared jina-rerank sidecar, Watchtower-labeled
* Dockerfile, requirements.txt, requirements-rerank.txt
Verified locally: scrape produced 1599 .md pages (some TOC entries
are parent-only and yield no body), 6353 chunks all under the 4 KB
cap, MCP server boots and lists 11 tools cleanly.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
118 lines
4.0 KiB
YAML
118 lines
4.0 KiB
YAML
# Hosting stack for a docs MCP server.
|
|
#
|
|
# Replace hvm below with your product name on first deploy.
|
|
# Volumes: usage logs are mounted to a host path so they survive
|
|
# Watchtower-driven container recreates.
|
|
#
|
|
# This template assumes a reverse proxy / Cloudflare Tunnel terminates
|
|
# TLS in front of port 8000. Adjust if your infra differs.
|
|
|
|
services:
|
|
|
|
# The MCP server. Watchtower auto-pulls on :latest changes.
|
|
morpheus-docs-mcp:
|
|
image: git.jpaul.io/justin/morpheus-docs:latest
|
|
container_name: morpheus-docs-mcp
|
|
restart: unless-stopped
|
|
ports:
|
|
- "8000:8000"
|
|
environment:
|
|
PRODUCT_NAME: "morpheus"
|
|
PRODUCT_DOCS_URL: "https://support.hpe.com/hpesc/public/docDisplay?docId=sd00007732en_us"
|
|
|
|
# Streamable-HTTP transport. Stateless mode is required for
|
|
# production: clients don't lose sessions when Watchtower
|
|
# recreates the container.
|
|
MCP_TRANSPORT: streamable-http
|
|
MCP_HOST: 0.0.0.0
|
|
MCP_PORT: "8000"
|
|
|
|
# If you run MetaMCP or another gateway in front and reach
|
|
# this container via its compose DNS name (e.g. morpheus-docs-mcp:8000),
|
|
# add that hostname here. "*" disables the rebind check entirely.
|
|
MCP_ALLOWED_HOSTS: "morpheus-docs-mcp,localhost,127.0.0.1"
|
|
|
|
# Phase 6 — reranker sidecar (jina-reranker-v2-base via llama.cpp).
|
|
RERANK_URL: http://hvm-rerank:8080
|
|
RERANK_POOL: "200"
|
|
RERANK_TIMEOUT: "30"
|
|
|
|
# Phase 8 — hybrid retrieval (BM25 + dense + RRF).
|
|
# Eval on the HVM corpus (eval/results/baseline.md, 2026-05-22) shows
|
|
# BM25-default + reranker beats hybrid on every metric (MRR 0.920 vs
|
|
# 0.875). Leaving HYBRID_SEARCH off so search_docs runs BM25-first +
|
|
# reranker; dense is the fallback when BM25 finds nothing.
|
|
HYBRID_SEARCH: "false"
|
|
|
|
# Phase 10 — usage telemetry.
|
|
USAGE_LOG_DIR: /app/var/logs
|
|
USAGE_LOG_KEEP_DAYS: "90"
|
|
|
|
# Phase 12 — doc-bug submission gate. Off by default; on only
|
|
# in production after you've verified the endpoint contract.
|
|
DOC_BUG_SUBMIT_ENABLED: "false"
|
|
# DOC_BUG_API_URL: "https://docs-be.example.com/api/feedback"
|
|
volumes:
|
|
# Usage logs persist across container recreates.
|
|
- ./morpheus-docs-mcp-logs:/app/var/logs
|
|
depends_on:
|
|
- hvm-rerank
|
|
labels:
|
|
# Watchtower polls *only* containers with this label set true.
|
|
com.centurylinklabs.watchtower.enable: "true"
|
|
networks:
|
|
- mcp
|
|
|
|
# Reranker sidecar — llama.cpp serving jina-reranker-v2-base.
|
|
# Requires GPU access; adjust runtime/devices for your hardware.
|
|
#
|
|
# For dev / CPU-only hosts, swap this service for scripts/rerank_server.py
|
|
# (sentence-transformers ms-marco-MiniLM-L-6-v2). Same /v1/rerank shape,
|
|
# ~500ms/batch on CPU vs ~50ms on GPU with the jina GGUF.
|
|
hvm-rerank:
|
|
image: ghcr.io/ggml-org/llama.cpp:server-cuda
|
|
container_name: hvm-rerank
|
|
restart: unless-stopped
|
|
# Mount the GGUF model from the host. Download from huggingface
|
|
# (gguf-org/jina-reranker-v2-base-multilingual-GGUF) first.
|
|
volumes:
|
|
- /path/to/models:/models:ro
|
|
command: >
|
|
--model /models/jina-reranker-v2-base.Q8_0.gguf
|
|
--reranking
|
|
--host 0.0.0.0
|
|
--port 8080
|
|
--n-gpu-layers 99
|
|
--ctx-size 4096
|
|
deploy:
|
|
resources:
|
|
reservations:
|
|
devices:
|
|
- driver: nvidia
|
|
count: 1
|
|
capabilities: [gpu]
|
|
networks:
|
|
- mcp
|
|
|
|
# Watchtower — auto-pulls :latest on push.
|
|
# Only watches containers labeled `com.centurylinklabs.watchtower.enable=true`.
|
|
watchtower:
|
|
image: containrrr/watchtower:latest
|
|
container_name: watchtower
|
|
restart: unless-stopped
|
|
volumes:
|
|
- /var/run/docker.sock:/var/run/docker.sock
|
|
environment:
|
|
WATCHTOWER_POLL_INTERVAL: "300" # 5 min
|
|
WATCHTOWER_LABEL_ENABLE: "true"
|
|
WATCHTOWER_CLEANUP: "true" # remove old images after pull
|
|
# If your registry requires auth, mount a docker config:
|
|
# volumes:
|
|
# - ./registry-auth.json:/config.json:ro
|
|
networks:
|
|
- mcp
|
|
|
|
networks:
|
|
mcp:
|
|
driver: bridge
|