Server Hub

Server Hub ist ein Python-Dienst, der Serververwaltungs- und Betriebsdaten über zwei Schnittstellen bereitstellt:

• REST API, implementiert mit FastAPI

• MCP server, der Tools für MCP-fähige Clients und KI-Agenten bereitstellt

Beide Schnittstellen sind darauf ausgelegt, dieselben zugrunde liegenden Anwendungsfunktionen bereitzustellen, anstatt Geschäftslogik zu duplizieren.

Architektur

flowchart LR
    RESTClient["REST Client"] --> REST["REST API"]
    MCPClient["MCP Client / AI Agent"] --> MCP["MCP Server"]

    REST --> App["Application Layer"]
    MCP --> App

    App --> Domain["Domain / Models"]
    App --> Persistence["Persistence"]
    Persistence --> DB[("Database")]

REST und MCP stellen Schnittstellengrenzen um die Anwendungsschicht dar. Persistenzdetails bleiben hinter dieser Grenze.

Related MCP server: quads-mcp

MCP-Tools

Die MCP-Schnittstelle stellt folgende Tools bereit:

• search_servers

• get_server

• get_server_metrics

• get_active_alerts

• get_system_stats

• create_alert

Die MCP-Schicht bildet interne Anwendungsdaten auf clientorientierte Antworten ab, anstatt Persistenzimplementierungsdetails offenzulegen.

REST API

Die REST-Schnittstelle bietet Operationen für:

• Servererkennung und -abfrage

• Serverstatus

• Servermetriken

• aktive Warnungen

• Erstellung von Warnungen

• Systemstatistiken

Testen

Führen Sie die vollständige Testsuite mit dem folgenden Befehl aus:

pytest -q

Das Repository enthält separate Tests für die öffentlichen Schnittstellen und eine REST ↔ MCP-Äquivalenz-Testsuite.

tests/
├── test_api.py
├── test_mcp.py
└── test_rest_mcp_equivalence.py

Die REST ↔ MCP-Äquivalenz-Tests verifizieren, dass die beiden Schnittstellen äquivalente Fähigkeiten und Daten bereitstellen, ohne dass ihre Antworthüllen identisch sein müssen.

Projektstruktur

app/
├── api/
│   ├── domain/
│   ├── routes/
│   └── ...
├── mcp/
└── ...

tests/
docs/

Die Implementierung ist um Anwendungs-/Domänenlogik und Schnittstellenadapter organisiert.

Dokumentation

Weitere Architektur- und Entscheidungsdokumente können im Laufe der Projektentwicklung unter docs/ hinzugefügt werden.

Entwicklung

Erstellen Sie eine virtuelle Umgebung, installieren Sie die Projektabhängigkeiten und führen Sie die Tests aus:

python -m venv .venv
source .venv/bin/activate
pip install -e ".[test]"
pytest -q

Das Repository enthält außerdem Skripte/Komponenten, um die REST- und MCP-Dienste lokal auszuführen.

Designprinzipien

• Anwendungsverhalten unabhängig von Transportprotokollen halten.

• REST und MCP als Schnittstellenadapter behandeln.

• Persistenzdetails hinter der Anwendungsgrenze halten.

• Aussagekräftige Domänenbezeichner in MCP-orientierten Operationen bevorzugen.

• Öffentliche Schnittstellen und ihre semantische Äquivalenz testen.

Lizenz

In den aktuellen Projektmaterialien ist keine Lizenz angegeben.