Componente MCP Server — sgcAI | eSeGeCe

MCP Server

TsgcWSAPIServer_MCP trasforma un server HTTP o WebSocket sgc in un server Model Context Protocol. Pubblica i tuoi tool, prompt e risorse, e qualsiasi client che parla MCP, un agente dell'IDE, un assistente desktop o il tuo stesso codice, può richiamare la tua applicazione.

TsgcWSAPIServer_MCP

La metà server di MCP. Interpreta il JSON-RPC sul tuo endpoint, gestisce le sessioni, solleva un evento per ogni richiesta di tool, prompt o risorsa e può inviare notifiche e richieste avviate dal server verso il client.

Classe del componente

TsgcWSAPIServer_MCP

Scopo

Ospitare tool per client AI

Piattaforme

Windows, macOS, Linux, iOS e Android

sgcAI è autonomo. Questo componente è distribuito dentro sgcAI insieme al runtime sgcWebSockets Core su cui è costruito, quindi non c'è nessuna licenza base da acquistare.

Pubblica i tuoi tool ai client AI

Collega l'API a un server, compila ServerInfo, gestisci gli eventi di richiesta, imposta Active.

uses
  sgcAI, sgcAI_MCP_Classes, sgcHTTP_Server;

var
  oMCP: TsgcWSAPIServer_MCP;
begin
  oMCP := TsgcWSAPIServer_MCP.Create(nil);
  oMCP.Server := sgcHTTPServer1;
  oMCP.EndpointOptions.Endpoint := '/mcp';

  oMCP.MCPOptions.ServerInfo.Name    := 'sgc-mcp-server';
  oMCP.MCPOptions.ServerInfo.Version := '1.0.0';
  oMCP.MCPOptions.SessionTimeout     := 300;

  // Streamable HTTP enables notifications and server to client requests.
  oMCP.TransportOptions.Http.Enabled           := True;
  oMCP.TransportOptions.HttpStreamable.Enabled := True;

  oMCP.OnMCPInitialize     := SrvInitialize;
  oMCP.OnMCPSessionNew     := SrvSessionNew;
  oMCP.OnMCPRequestTool    := SrvCallTool;
  oMCP.OnMCPRequestPrompt  := SrvGetPrompt;
  oMCP.OnMCPRequestResource := SrvReadResource;

  sgcHTTPServer1.Active := True;

  // Tell every connected session the tool list changed.
  oMCP.SendNotificationToolsListChanged;
end;
// includes: sgcAI.hpp, sgcAI_MCP_Classes.hpp, sgcHTTP_Server.hpp

TsgcWSAPIServer_MCP *oMCP = new TsgcWSAPIServer_MCP(NULL);
oMCP->Server = sgcHTTPServer1;
oMCP->EndpointOptions->Endpoint = "/mcp";

oMCP->MCPOptions->ServerInfo->Name    = "sgc-mcp-server";
oMCP->MCPOptions->ServerInfo->Version = "1.0.0";

oMCP->TransportOptions->HttpStreamable->Enabled = true;
oMCP->OnMCPRequestTool = SrvCallTool;

sgcHTTPServer1->Active = true;

Proprietà e metodi principali

I membri che userai più spesso.

Collegamento al server

Server punta al server HTTP o WebSocket che resta in ascolto, e EndpointOptions.Endpoint è il percorso su cui arrivano le richieste JSON-RPC.

MCPOptions

ServerInfo è quello che i client vedono durante l'handshake. SessionTimeout fa scadere le sessioni inattive, TasksSupported dichiara la capability dei task e AuthenticationOptions copre chiave API, header personalizzato e OAuth 2.0.

TransportOptions

Http.Enabled serve JSON-RPC semplice su POST. HttpStreamable.Enabled aggiunge il keep-alive più il flusso di notifiche SSE, ed è questo che rende possibili le notifiche e le richieste avviate dal server. HttpStreamable.ValidateOrigin vincola una sessione al suo header Origin originale.

Cataloghi

Tools, Prompts, Resources e ResourceTemplates contengono ciò che il server dichiara. Riempili all'avvio oppure modificali a runtime e invia la notifica di lista modificata corrispondente.

Eventi di richiesta

OnMCPRequestTool, OnMCPRequestPrompt e OnMCPRequestResource sono i punti in cui il tuo codice fa il lavoro. OnMCPInitialize, OnMCPSessionNew e OnMCPSessionEnd seguono il ciclo di vita della sessione, e OnMCPException segnala i fallimenti.

Notifiche

SendNotificationToolsListChanged, SendNotificationPromptsListChanged, SendNotificationResourcesListChanged, SendNotificationResourcesUpdated e SendLogMessage inviano gli aggiornamenti alle sessioni connesse.

Richieste avviate dal server

RequestRootsList, RequestSamplingCreateMessage e RequestElicitationCreate permettono al server di chiedere al client le root del filesystem, un completamento del modello o un input dell'utente, con la risposta sull'evento OnMCPResponse* corrispondente.

OAuth 2.0 integrato

Il componente implementa il lato authorization server del flusso di autenticazione MCP, inclusi la registrazione dinamica del client, una pagina di consenso, PKCE e i refresh token, così un agente può autorizzarsi contro il tuo server senza un servizio di identità separato.

Specifiche e riferimenti

Fonti autorevoli per i servizi e i protocolli usati da questo componente.

Continua a esplorare

Guida onlineRiferimento API completo e guida all'utilizzo dei componenti sgcAI.
Tutti i componenti sgcAIEsplora la matrice completa delle funzionalità di tutti e 15 i componenti.
Scarica la versione di prova gratuitaEsponi la logica della tua applicazione a un client AI.
PrezziLicenze Single, Team e Site, codice sorgente completo, nessun prodotto base richiesto.
La scelta più conveniente: All-AccessTutti i prodotti eSeGeCe, con Supporto Premium incluso, a partire da €1,059/anno.
Vedi i prezzi All-Access

Pronto per iniziare?

Scarica la versione di prova gratuita e lascia che un agente AI richiami la tua applicazione tramite MCP.