Eigenen MCP-Server in die kagent-Referenzarchitektur einbinden

Übersicht

Diese Lösung bietet einen standardisierten, sicheren und skalierbaren Mechanismus für die Integration von Model Context Protocol (MCP)-Servern in Distributed Cloud Software Only (GDC)-Umgebungen, in denen kagent als agentische KI-Plattform bereitgestellt wird.

Das Hauptproblem, das hier angegangen wird, ist das Fehlen einer einheitlichen Schnittstelle, um LLM-Anwendungen (Large Language Model) mit lokalisierten Datenquellen und Tools in regulierten GDC-Clustern zu verbinden. Diese Architektur bietet ein BYO-Framework (Bring Your Own), mit dem Entwickler benutzerdefinierte MCP-Server bereitstellen können, die bestimmte Unternehmensfunktionen als Tools für KI-Agenten verfügbar machen.

Diese Architektur umfasst die Kommunikationsprotokolle zwischen kagent- und MCP-Servern sowie die Komponententopologie in GDC. Die interne Logik von MCP-Servern von Drittanbietern ist nicht enthalten.

Die Zielgruppe für dieses Dokument umfasst GDC-Plattformadministratoren, KI-Anwendungsentwickler und Sicherheitsprüfer, die für die Genehmigung externer Tool-Integrationen verantwortlich sind.

Funktionen

kagent bietet ein flexibles Framework, mit dem Organisationen BYO-MCP-Server verwenden können, um LLMs in lokale oder proprietäre Tools einzubinden. Mit dieser Funktion können KI-Agenten mit spezialisierten Datenquellen interagieren und komplexe Aufgaben innerhalb des Perimeters eines GDC-Clusters ausführen.

Funktionale Komponenten und Verantwortlichkeiten

Die Architektur umfasst die folgenden funktionalen Komponenten:

  • KI-Agentenplattform (kagent): Fungiert als zentraler Orchestrator. Er verwaltet den Lebenszyklus der agentischen Sitzung, leitet Nutzeranfragen an das LLM weiter und koordiniert die Toolausführung über den MCP-Client.
  • LLM: Übernimmt Natural Language Understanding und das Ziehen von Schlussfolgerungen. Sie bestimmt, wann ein bestimmtes Tool erforderlich ist, um eine Anfrage zu erfüllen, und generiert die Parameter, die zum Aufrufen dieses Tools erforderlich sind.
  • MCP-Server: Stellt bestimmte Tools über MCP als eigenständigen Dienst bereit. Sie übernimmt die Low-Level-Logik der Interaktion mit Backend-Unternehmenssystemen oder Daten-Repositories.

Schnittstellen und Datenfluss

Die End-to-End-Architektur basiert auf standardisierten Schnittstellen, um Interoperabilität und Sicherheit zu gewährleisten:

  • MCP-Transport: kagent kommuniziert mit dem MCP-Server über standardisiertes JSON-RPC über einen unterstützten MCP-Transport, z. B. Streamable HTTP (oder HTTP mit SSE) oder stdio. Diese Schnittstelle definiert, wie Tools erkannt, beschrieben und aufgerufen werden.
  • Datenfluss: Der Anfragelebenszyklus umfasst die folgenden Schritte:
    1. Der Nutzer sendet einen Prompt an kagent.
    2. kagent leitet den Prompt an das LLM weiter.
    3. Das LLM identifiziert einen Toolaufruf und gibt ihn an kagent zurück.
    4. kagent leitet die Anfrage an den MCP-Server weiter.
    5. Der MCP-Server führt das Tool für die lokale Datenquelle aus und gibt das Ergebnis zurück.
    6. Der KI-Agent sendet das Ergebnis zurück an das LLM, um die endgültige Antwort zu generieren.

Architektur

Um zu demonstrieren, wie ein BYO-MCP-Server bereitgestellt und verwendet wird, nutzt diese Referenzarchitektur die Open-Source-Anwendung Nextcloud, ihren MCP-Server und den Nextcloud-Agenten auf Solo Enterprise for kagent.

In diesem Beispiel wird das Gemma 4-Modell mit vLLM bereitgestellt.

Die Architektur verbindet Nextcloud, kagent und das Gemma 4-Modell innerhalb der GDC-Umgebung. In dieser Konfiguration verwendet kagent Nextcloud als Daten-Repository, sodass das Gemma 4-Modell über standardisierte MCP-Schnittstellen auf Informationen in Nextcloud zugreifen und diese verarbeiten kann.

Nextcloud ist eine selbst gehostete Open-Source-Plattform für Zusammenarbeit und Cloud-Speicher, die die lokale Bereitstellung unterstützt, damit Sie die Kontrolle und den Datenschutz über Nutzerdaten behalten. Sie ist eine Komponente von openDesk.

Nextcloud bietet die folgenden Funktionen:

  • Dateisynchronisierung und -freigabe: Dateien speichern, über spezielle Apps auf Computern und Mobilgeräten synchronisieren und über Links freigeben.
  • Produktivitätstools: Nutzen Sie integrierte Kalender, Kontakte, Aufgabenverwaltung und E‑Mail-Clients.
  • Zusammenarbeit: Office-Suites wie Collabora Online oder ONLYOFFICE lassen sich direkt in Nextcloud einbinden, um Dokumente, Tabellen und Präsentationen in Echtzeit gemeinsam zu bearbeiten.
  • Erweiterbarkeit: Installieren Sie Plug-ins aus dem App Store, um Funktionen wie Passwortmanager, Kanban-Boards oder Musikplayer hinzuzufügen.

Für diese Lösung ist GDC mit kagent und vLLM erforderlich, um das Gemma 4-Modell bereitzustellen. Das folgende Diagramm veranschaulicht die Validierungseinrichtung:

Validierungseinrichtung mit GDC, kagent, Nextcloud und vLLM, die Gemma 4 bereitstellen.

Zusätzliche Materialien