simplify Athena runtime and centralize MCP management

2026-08-26 09:57:38 +02:00
parent 104c9904a5
commit ab671a6396
31 changed files with 918 additions and 419 deletions
@@ -0,0 +1,57 @@
+#!/usr/bin/env python3
+"""Render the human-readable MCP list from the single JSON registry."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import pathlib
+
+
+ROOT = pathlib.Path(__file__).resolve().parents[2]
+REGISTRY = ROOT / "config" / "mcp-registry.json"
+OUTPUT = ROOT / "docs" / "MCP_SERVERS.md"
+
+
+def render() -> str:
+    document = json.loads(REGISTRY.read_text(encoding="utf-8"))
+    rows = []
+    for item in document["servers"]:
+        if not item.get("hub"):
+            continue
+        clients = ", ".join(item.get("clients", [])) or "–"
+        selection = str(len(item["tool_include"])) if item.get("tool_include") else "alle"
+        rows.append(
+            f"| {item['name']} | `{item['hermes_id']}` | `{item['url']}` | "
+            f"{clients} | {selection} |"
+        )
+    return "\n".join([
+        "# MCP-Server",
+        "",
+        "Diese Datei wird aus `config/mcp-registry.json` erzeugt. Änderungen gehören nur in die JSON-Registry.",
+        "",
+        "| Server | Hermes-ID | Endpunkt | Clients | Werkzeuge |",
+        "|---|---|---|---|---:|",
+        *rows,
+        "",
+        "Allgemeine Webrecherche ist ein eingebautes Hermes-Werkzeug und kein MCPHub-Server.",
+        "",
+    ])
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--check", action="store_true")
+    args = parser.parse_args()
+    expected = render()
+    if args.check:
+        if not OUTPUT.is_file() or OUTPUT.read_text(encoding="utf-8") != expected:
+            raise SystemExit("MCP registry documentation is out of date")
+        print("MCP_REGISTRY_OK")
+        return
+    OUTPUT.write_text(expected, encoding="utf-8")
+    print("MCP_REGISTRY_RENDERED")
+
+
+if __name__ == "__main__":
+    main()