Delphi MCP-Server Tools (2/4)

· Funktionen

Mit dem Release von sgcWebSockets 2025.9.0 können Entwickler die Funktionalität des Model Context Protocol (MCP) direkt in ihre Server integrieren. Dazu gehört die Verarbeitung von MCP-Tool-Requests, einer Schlüsselkomponente für dynamische und intelligente Kommunikation zwischen KI-Modellen und Backend-Diensten.

Diese Anleitung zeigt dir, wie MCP-Tool-Requests funktionieren, wie du sie in deinem TsgcWSAPIServer_MCP-Server verarbeitest und wie du strukturierte Antworten an den Client oder KI-Agenten zurücksendest. 

MCP-Tool-Requests verstehen

Im MCP-Ökosystem (Model Context Protocol) stehen Tools für Fähigkeiten, die ein KI-Modell aufrufen kann — etwa eine Datenbankabfrage, das Versenden einer E-Mail oder das Abrufen von Daten aus einer API.

Ein MCP-Server stellt diese Tools über WebSockets bereit; Clients (wie KI-Agenten) können Tool-Requests abschicken, um bestimmte Aktionen auszulösen. Die Komponente TsgcWSAPIServer_MCP in sgcWebSockets vereinfacht den gesamten Ablauf: Sie dekodiert MCP-Nachrichten automatisch und leitet sie an die passenden Event-Handler in deinem Server weiter. 

So funktionieren MCP-Tool-Requests

Der Kommunikationsablauf sieht typischerweise so aus:

  1. Der Client sendet einen Tool-Request (eine MCP-Nachricht im JSON-Format) an den MCP-Server.
  2. sgcWebSockets parst die Anfrage und löst ein Ereignis wie OnToolRequest aus.
  3. Der Server führt die angeforderte Aktion aus — z. B. liest aus einem CRM, fragt eine Datenbank ab oder rechnet etwas.
  4. Der Server baut eine Antwort im MCP-Format zusammen (inklusive Ergebnisdaten oder Fehlern).
  5. Die Antwort wird an den anfragenden Client zurückgesendet.

Jeder MCP-Tool-Request wird identifiziert durch:

Tool-Requests in Delphi verarbeiten

Sobald dein MCP-Server mit TsgcWSAPIServer_MCP konfiguriert ist, kannst du eingehende Tool-Requests über Event-Handler verarbeiten.
Hier ein Beispiel, wie sich ein Handler für eingehende MCP-Tool-Requests umsetzen lässt: 

procedure TMainForm.MCPServerMCPRequestTool(Sender: TObject;
  const ASession: TsgcAI_MCP_Session;
  const ARequest: TsgcAI_MCP_Request_ToolsCall;
  const AResponse: TsgcAI_MCP_Response_ToolsCall);
var
  LA, LB: Double;
begin
  if ARequest.Params.Name = 'math.add' then
  begin
    LA := ARequest.Params.Arguments.Node['a'].AsNumber;
    LB := ARequest.Params.Arguments.Node['b'].AsNumber;
    AResponse.Result.Content.AddText(Format('Sum = %.2f', [LA + LB]));
  end
  else
    AResponse.Result.IsError := True;
end;

MCP-Tool-Metadaten nutzen

Du kannst Metadaten zu den verfügbaren Tools über die MCP-API registrieren und veröffentlichen.
So können KI-Modelle deine Tools dynamisch entdecken und ihre erwarteten Parameter verstehen.

Zum Beispiel kannst du deklarieren: 

procedure TMainForm.FormCreate(Sender: TObject);
var
  oTool: TsgcAI_MCP_Tool;
begin
  oTool := MCPServer.Tools.AddTool('math.add', 'Adds two numbers');
  oTool.InputSchema.Properties.AddProperty('a', True, aimcpjtNumber, 'Left operand');
  oTool.InputSchema.Properties.AddProperty('b', True, aimcpjtNumber, 'Right operand');
end;

Diese Informationen helfen KI-Clients dabei, automatisch zu verstehen, wie sie deine Tools aufrufen sollen. So lassen sich leichter selbst-dokumentierende KI-Integrationen aufbauen. 

Zusammenfassung

MCP-Tool-Requests in sgcWebSockets 2025.9.0 bieten einen einfachen, aber leistungsstarken Weg, KI-Modelle mit realen Systemen zu verbinden.
Mit der Komponente TsgcWSAPIServer_MCP und ihrem integrierten Tool-Request-Handling kannst du:

Mehr erfahren

Einen tieferen Einblick in die MCP-API und die verfügbaren Server-Komponenten findest du in der offiziellen Dokumentation:


👉 sgcWebSockets MCP-Tools-Server-Referenz 


Hier findest du eine Delphi-MCP-Server-Demo für Windows.