O TsgcWSAPIClient_MCP é a metade cliente do Model Context Protocol. Ele se conecta a qualquer servidor MCP, por HTTP, HTTP Streamable ou um subprocesso stdio local, lista as ferramentas, prompts e recursos que ele oferece, e os chama a partir do seu código.
Um cliente MCP JSON-RPC com três transportes. Ele faz o handshake de inicialização, acompanha a sessão, emite requisições e responde àquelas iniciadas pelo servidor que a sua aplicação escolher suportar.
TsgcWSAPIClient_MCP
Consumir servidores MCP
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.
Defina o transporte e suas opções, inicialize, e então liste e chame ferramentas, prompts e recursos.
uses
sgcAI, sgcAI_MCP_Classes, sgcAI_MCP_Types;
var
oMCP: TsgcWSAPIClient_MCP;
begin
oMCP := TsgcWSAPIClient_MCP.Create(nil);
// Remote server over streamable HTTP.
oMCP.MCPOptions.Transport := aimcptrHttpStreamable;
oMCP.MCPOptions.HttpOptions.URL := 'https://mcp.example.com/mcp';
oMCP.MCPOptions.ClientInfo.Name := 'sgc-mcp-client';
oMCP.MCPOptions.ClientInfo.Version := '1.0.0';
oMCP.MCPOptions.AuthenticationOptions.ApiKey.Enabled := True;
oMCP.MCPOptions.AuthenticationOptions.ApiKey.Value := 'mcp-...';
oMCP.OnMCPListTools := MCPListTools;
oMCP.OnMCPResponseTool := MCPToolResponse;
oMCP.Initialize;
oMCP.ListTools;
oMCP.RequestTool('GetTemperature', vArguments); // vArguments: IsgcJSON
end;
// Or spawn a local MCP server as a subprocess instead:
oMCP.MCPOptions.Transport := aimcptrStdio;
oMCP.MCPOptions.StdioOptions.Command := 'C:\tools\my-mcp-server.exe';
oMCP.MCPOptions.StdioOptions.Arguments := '--stdio';// includes: sgcAI.hpp, sgcAI_MCP_Classes.hpp, sgcAI_MCP_Types.hpp
TsgcWSAPIClient_MCP *oMCP = new TsgcWSAPIClient_MCP(NULL);
oMCP->MCPOptions->Transport = aimcptrHttpStreamable;
oMCP->MCPOptions->HttpOptions->URL = "https://mcp.example.com/mcp";
oMCP->MCPOptions->ClientInfo->Name = "sgc-mcp-client";
oMCP->OnMCPListTools = MCPListTools;
oMCP->OnMCPResponseTool = MCPToolResponse;
oMCP->Initialize();
oMCP->ListTools();Os membros que você usa com mais frequência.
MCPOptions.Transport escolhe aimcptrHttp para JSON-RPC puro sobre POST, aimcptrHttpStreamable para keep-alive mais um stream de notificações SSE, ou aimcptrStdio para iniciar um servidor local como subprocesso.
HttpOptions guarda a URL, as opções de TLS e o log. StdioOptions guarda Command, Arguments, WorkingDir, Environment e Timeout do subprocesso.
AuthenticationOptions suporta chave de API, cabeçalho personalizado ou um fluxo OAuth 2.0 completo, incluindo asserção de identidade, que é o que os servidores MCP públicos exigem cada vez mais.
Initialize faz o handshake e Ping verifica se a conexão está viva. HeartBeat envia pings periódicos para que uma sessão ociosa não seja derrubada, e Session expõe o estado negociado da sessão.
ListTools e RequestTool, ListPrompts e RequestPrompt, ListResources, ListResourceTemplates e RequestResource. As listagens aceitam um argumento de cursor para paginação.
SubscribeResource e UnsubscribeResource acompanham as mudanças de um recurso, SetLoggingLevel ajusta o nível de detalhe no servidor, e Complete pede sugestões de preenchimento de argumentos.
OnMCPListRoots, OnMCPSamplingCreateMessage e OnMCPElicitationCreate disparam quando o servidor pede ao cliente as raízes do sistema de arquivos, uma resposta do modelo ou uma entrada do usuário, para que a sua aplicação forneça a resposta. Um servidor legado (2025-11-25 ou anterior) que envia essas solicitações diretamente, fora de Multi Round-Trip Requests, tem sua resposta enviada automaticamente assim que o handler retorna.
OnMCPInitialize, OnMCPPing, OnMCPListTools, OnMCPResponseTool, OnMCPListPrompts, OnMCPResponsePrompt, OnMCPListResources, OnMCPResponseResource e OnMCPStreamMessage.
MCPOptions.ProtocolEra seleciona Auto, Modern ou Legacy. No modo Auto, o cliente chama server/discover e recorre ao handshake initialize de 2025-11-25 quando o servidor é mais antigo. Discover, NegotiatedEra e OnMCPDiscover expõem o resultado.
Quando um servidor precisa de elicitation, sampling ou roots para concluir uma chamada, OnMCPInputRequired dispara com as solicitações. Preencha as respostas e o cliente repete a chamada com o requestState assinado, até o limite de MCPOptions.MRTR.MaxRounds.
SubscriptionsListen abre um stream para mudanças de listas e atualizações de recursos, entregues por OnMCPListChanged e OnMCPResourcesUpdated. SubscriptionsCancel o encerra.
MCPOptions.Tasks.Enabled declara a extensão; AutoPoll consulta uma tarefa em execução automaticamente. TasksGet, TasksUpdate e TasksCancel são os métodos manuais, e OnMCPTaskCreated, OnMCPTaskStatus e OnMCPTaskCompleted reportam o progresso.
MCPOptions.Authorization descobre metadados de recurso protegido, registra-se por meio de Client ID Metadata Documents ou registro dinâmico com application_type, usa PKCE e indicadores de recurso, valida iss (RFC 9207) e mantém credenciais por emissor.
Fontes oficiais dos serviços e protocolos que este componente usa.
| Ajuda onlineReferência completa da API e guia de uso dos componentes sgcAI. | Abrir | |
| Todos os componentes sgcAIExplore a matriz de recursos completa dos 15 componentes. | Abrir | |
| Baixar avaliação gratuitaConecte-se a um servidor MCP público ou local a partir do seu próprio código. | Abrir | |
| PreçosLicenças Single, Team e Site, código-fonte completo. | Abrir |