Servidor Delphi MCP: Prompts (3/4)

· Recursos
Com o sgcWebSockets 2025.9.0, o servidor Model Context Protocol (MCP) agora suporta Prompt Requests, permitindo que clientes de IA consultem e renderizem templates de prompt dinâmicos. Esse recurso possibilita expor prompts de IA reutilizáveis (como "summarize text" ou "review code") diretamente por WebSockets usando o padrão MCP.

O que são os MCP Prompt Requests?

No MCP, Prompts são templates estruturados que os clientes podem descobrir e usar para gerar entradas de modelo de forma consistente.
Cada servidor MCP expõe:

  1. prompts/list — para enumerar os prompts disponíveis.
  2. prompts/get — para renderizar um prompt específico com argumentos fornecidos.
  3. notifications/prompts/list_changed — para notificar os clientes quando o catálogo de prompts mudar.

Isso permite que grandes modelos de linguagem ou agentes recuperem templates disponíveis e os renderizem dinamicamente com contexto.

Listando prompts

Quando um cliente chama prompts/list, seu servidor deve retornar um array de definições de prompts, incluindo o nome, a descrição e o schema de argumentos de cada prompt.

Exemplo de código que publica um prompt de code review: 

procedure TMainForm.FormCreate(Sender: TObject);
var
  oPrompt: TsgcAI_MCP_Prompt;
begin
  MCPServer.Prompts.Clear;
  oPrompt := MCPServer.Prompts.AddPrompt('CodeReview',
    'Asks the LLM to analyze code quality and suggest improvements');
  oPrompt.Arguments.AddArgument('code', 'The code to review', True);
end;

Requisição de Prompt

Quando um cliente emite uma requisição JSON-RPC prompts.call, o TsgcWSAPIServer_MCP hidrata o objeto de requisição fortemente tipado (incluindo o nome da ferramenta e os argumentos fornecidos) antes de disparar o evento OnMCPRequestPrompt. Seu handler preenche o payload da resposta que é então serializado de volta para o cliente, junto com um código de status HTTP de sucesso.

Um handler típico se parece com isto: 

procedure TFRMMCPServer.MCPServerMCPRequestPrompt(Sender: TObject;
  const aSession: TsgcAI_MCP_Session; const aRequest: TsgcAI_MCP_Request_PromptsGet;
  const aResponse: TsgcAI_MCP_Response_PromptsGet);
begin
  if aRequest.Params.Name = 'CodeReview' then
  begin
    aResponse.Result.Description := 'Code review prompt';
    aResponse.Result.Messages.AddText('user',
      'Please review this Delphi code: ShowMessage(''Hello World'' ');
  end;
end;

Com os MCP Prompts agora integrados ao sgcWebSockets 2025.9.0, os desenvolvedores podem criar servidores WebSocket cientes de IA que expõem prompts estruturados, descobríveis e dinâmicos — fazendo a ponte entre LLMs e dados de aplicação em tempo real. 

Saiba mais

Para documentação aprofundada e referência do componente, visite:

Guia do servidor de Prompts MCP do sgcWebSockets 


Veja abaixo um demo do Delphi MCP Server para Windows