build out morpheus-docs MCP stack, mirroring hvm-docs through Phases 1-13

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>
This commit is contained in:
2026-05-22 15:26:24 -04:00
parent 43728320bf
commit fa448f94e1
22 changed files with 2822 additions and 247 deletions
+119
View File
@@ -0,0 +1,119 @@
[
{
"slug": "morpheus_user_manual_8_1_0",
"doc_id": "sd00007510en_us",
"title": "HPE Morpheus Enterprise Software Documentation v8.1.0",
"version": "8.1.0",
"platform": null,
"product": "User Manual",
"language": "en-US",
"page_count": 568,
"mode": "toc",
"abstract": "",
"dates": {
"Published": "February 2026"
},
"landing_page": "GUID-709AAADB-A9C1-40B6-AD22-958EE7E6F312",
"source_url": "https://support.hpe.com/hpesc/public/docDisplay?docId=sd00007510en_us"
},
{
"slug": "morpheus_user_manual_8_1_1",
"doc_id": "sd00007621en_us",
"title": "HPE Morpheus Enterprise Software Documentation v8.1.1",
"version": "8.1.1",
"platform": null,
"product": "User Manual",
"language": "en-US",
"page_count": 569,
"mode": "toc",
"abstract": "",
"dates": {
"Published": "March 2026"
},
"landing_page": "GUID-709AAADB-A9C1-40B6-AD22-958EE7E6F312",
"source_url": "https://support.hpe.com/hpesc/public/docDisplay?docId=sd00007621en_us"
},
{
"slug": "morpheus_user_manual_8_1_2",
"doc_id": "sd00007732en_us",
"title": "HPE Morpheus Enterprise Software Documentation v8.1.2",
"version": "8.1.2",
"platform": null,
"product": "User Manual",
"language": "en-US",
"page_count": 569,
"mode": "toc",
"abstract": "",
"dates": {
"Published": "April 2026"
},
"landing_page": "GUID-709AAADB-A9C1-40B6-AD22-958EE7E6F312",
"source_url": "https://support.hpe.com/hpesc/public/docDisplay?docId=sd00007732en_us"
},
{
"slug": "morpheus_release_notes_8_1_0",
"doc_id": "sd00007496en_us",
"title": "v8.1.0 Release Notes",
"version": "8.1.0",
"platform": null,
"product": "Release Notes",
"language": "en-US",
"page_count": 1,
"mode": "single",
"abstract": "Release notes for HPE Morpheus Enterprise Software version v8.1.0",
"dates": {
"Published": "February 2026"
},
"landing_page": "sd00007496en_us",
"source_url": "https://support.hpe.com/hpesc/public/docDisplay?docId=sd00007496en_us"
},
{
"slug": "morpheus_release_notes_8_1_1",
"doc_id": "sd00007610en_us",
"title": "v8.1.1 Release Notes",
"version": "8.1.1",
"platform": null,
"product": "Release Notes",
"language": "en-US",
"page_count": 1,
"mode": "single",
"abstract": "Release notes for HPE Morpheus Enterprise Software version v8.1.1",
"dates": {
"Published": "March 2026"
},
"landing_page": "sd00007610en_us",
"source_url": "https://support.hpe.com/hpesc/public/docDisplay?docId=sd00007610en_us"
},
{
"slug": "morpheus_release_notes_8_1_2",
"doc_id": "sd00007733en_us",
"title": "v8.1.2 Release Notes",
"version": "8.1.2",
"platform": null,
"product": "Release Notes",
"language": "en-US",
"page_count": 1,
"mode": "single",
"abstract": "Release notes for HPE Morpheus Enterprise Software version v8.1.2",
"dates": {
"Published": "April 2026"
},
"landing_page": "sd00007733en_us",
"source_url": "https://support.hpe.com/hpesc/public/docDisplay?docId=sd00007733en_us"
},
{
"slug": "morpheus_quickspecs",
"doc_id": "a50009231enw",
"title": "HPE Morpheus Enterprise Software QuickSpecs",
"version": "v1",
"platform": null,
"product": "QuickSpecs",
"language": "en-US",
"page_count": 1,
"mode": "html-file",
"abstract": "",
"dates": {},
"landing_page": "a50009231enw",
"source_url": "https://www.hpe.com/psnow/doc/a50009231enw"
}
]