Componente Servidor MCP — sgcAI | eSeGeCe

Servidor MCP

O TsgcWSAPIServer_MCP transforma um servidor HTTP ou WebSocket sgc em um servidor Model Context Protocol. Publique suas próprias ferramentas, prompts e recursos, e qualquer cliente compatível com MCP, um agente de IDE, um assistente de desktop ou seu próprio código, pode chamar sua aplicação.

TsgcWSAPIServer_MCP

A metade servidor do MCP. Ele interpreta o JSON-RPC no seu endpoint, gerencia sessões, dispara um evento por requisição de ferramenta, prompt ou recurso, e pode enviar notificações e requisições iniciadas pelo servidor de volta ao cliente.

Classe do componente

TsgcWSAPIServer_MCP

Finalidade

Hospedar ferramentas para clientes de IA

Plataformas

Windows, macOS, Linux, iOS e Android

O sgcAI é autossuficiente. Este componente vem dentro do sgcAI junto com o runtime sgcWebSockets Core sobre o qual foi construído, então não há licença base para comprar.

Publique suas ferramentas para clientes de IA

Vincule a API a um servidor, preencha o ServerInfo, trate os eventos de requisição e defina 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;

Principais propriedades & métodos

Os membros que você usa com mais frequência.

Vínculo com o servidor

Server aponta para o servidor HTTP ou WebSocket que escuta, e EndpointOptions.Endpoint é o caminho pelo qual chegam as requisições JSON-RPC.

MCPOptions

ServerInfo é o que os clientes veem durante o handshake. SessionTimeout expira sessões ociosas, TasksSupported anuncia a capacidade de tarefas, e AuthenticationOptions cobre chave de API, cabeçalho personalizado e OAuth 2.0.

TransportOptions

Http.Enabled serve JSON-RPC puro sobre POST. HttpStreamable.Enabled adiciona keep-alive mais o stream de notificações SSE, que é o que torna possíveis as notificações e as requisições iniciadas pelo servidor. HttpStreamable.ValidateOrigin fixa uma sessão ao seu cabeçalho Origin original.

Catálogos

Tools, Prompts, Resources e ResourceTemplates guardam o que o servidor anuncia. Preencha-os na inicialização ou altere-os em tempo de execução e envie a notificação de lista alterada correspondente.

Eventos de requisição

OnMCPRequestTool, OnMCPRequestPrompt e OnMCPRequestResource são onde o seu código faz o trabalho. OnMCPInitialize, OnMCPSessionNew e OnMCPSessionEnd acompanham o ciclo de vida da sessão, e OnMCPException reporta falhas.

Notificações

SendNotificationToolsListChanged, SendNotificationPromptsListChanged, SendNotificationResourcesListChanged, SendNotificationResourcesUpdated e SendLogMessage enviam atualizações às sessões conectadas.

Requisições iniciadas pelo servidor

RequestRootsList, RequestSamplingCreateMessage e RequestElicitationCreate permitem que o servidor peça ao cliente as raízes do sistema de arquivos, uma resposta do modelo ou uma entrada do usuário, respondidas no evento OnMCPResponse* correspondente.

OAuth 2.0 integrado

O componente implementa o lado do servidor de autorização do fluxo de autenticação MCP, incluindo registro dinâmico de cliente, uma página de consentimento, PKCE e refresh tokens, de modo que um agente pode se autorizar no seu servidor sem um serviço de identidade separado.

Especificações & referências

Fontes oficiais dos serviços e protocolos que este componente usa.

Continue explorando

Ajuda onlineReferência completa da API e guia de uso dos componentes sgcAI.
Todos os componentes sgcAIExplore a matriz de recursos completa dos 15 componentes.
Baixar avaliação gratuitaExponha a lógica da sua própria aplicação a um cliente de IA.
PreçosLicenças Single, Team e Site, código-fonte completo, sem necessidade de produto base.
Melhor custo-benefício: All-AccessTodos os produtos da eSeGeCe, com Suporte Premium incluído, a partir de €1,059/ano.
Ver preços do All-Access

Pronto para começar?

Baixe a versão de avaliação gratuita e deixe um agente de IA chamar sua aplicação através do MCP.