Com o lançamento do sgcWebSockets 2025.9.0, os desenvolvedores agora podem integrar a funcionalidade Model Context Protocol (MCP) diretamente em seus servidores. Isso inclui a capacidade de tratar MCP Tool Requests, um componente fundamental para viabilizar comunicação dinâmica e inteligente entre modelos de IA e serviços de backend.
Este guia irá conduzir você por como os MCP Tool Requests funcionam, como tratá-los em seu servidor TsgcWSAPIServer_MCP e como enviar respostas estruturadas de volta ao cliente ou agente de IA.
Entendendo os MCP Tool Requests
No ecossistema MCP (Model Context Protocol), Tools representam capacidades que um modelo de IA pode invocar — por exemplo, consultar um banco de dados, enviar um e-mail ou buscar dados de uma API.
Um servidor MCP expõe essas ferramentas por WebSockets, e os clientes (como agentes de IA) podem fazer Tool Requests para disparar ações específicas. O componente TsgcWSAPIServer_MCP no sgcWebSockets simplifica todo o fluxo, decodificando automaticamente as mensagens MCP e roteando-as para os handlers de evento apropriados em seu servidor.
Como os MCP Tool Requests funcionam
O fluxo de comunicação normalmente se parece com isto:
- O cliente envia um Tool Request (mensagem MCP em formato JSON) para o servidor MCP.
- O sgcWebSockets faz o parse da requisição e dispara um evento como
OnToolRequest. - O servidor executa a ação solicitada — por exemplo, lê de um CRM, consulta um banco de dados ou realiza um cálculo.
- O servidor constrói uma resposta em formato MCP (incluindo quaisquer dados de resultado ou erros).
- A resposta é enviada de volta ao cliente solicitante.
Cada MCP Tool Request é identificado por:
- Um nome de ferramenta (a operação a executar)
- Parâmetros (entradas de contexto ou dados)
- Um ID (usado para correlacionar requisição e resposta)
Tratando Tool Requests em Delphi
Depois de configurar seu servidor MCP usando TsgcWSAPIServer_MCP, você pode tratar requisições de ferramentas que chegam por meio de handlers de evento.
Abaixo está um exemplo de como implementar um handler para MCP Tool Requests recebidos.
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;
Usando metadados de MCP Tools
Você também pode registrar e expor metadados sobre as ferramentas disponíveis usando a API MCP.
Isso permite que os modelos de IA descubram suas ferramentas disponíveis dinamicamente e entendam seus parâmetros esperados.
Por exemplo, você pode declarar:
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;
Essa informação ajuda os clientes de IA a entender automaticamente como chamar suas ferramentas, facilitando a criação de integrações de IA auto-documentadas.
Resumo
Os MCP Tool Requests no sgcWebSockets 2025.9.0 fornecem uma forma simples, mas poderosa, de conectar seus modelos de IA com sistemas do mundo real.
Ao usar o componente TsgcWSAPIServer_MCP e seu tratamento integrado de Tool Requests, você pode:
- Criar endpoints de ferramentas estruturados e descobríveis
- Responder a requisições de IA ao vivo em tempo real
- Integrar sistemas de negócio (CRMs, APIs, bancos de dados) perfeitamente
- Manter controle total e transparência sobre as interações IA-sistema
Saiba mais
Para uma análise mais profunda da API MCP e dos componentes de servidor disponíveis, visite a documentação oficial:
👉 Referência do servidor de MCP Tools do sgcWebSockets
Veja abaixo um demo do Delphi MCP Server para Windows.