Delphi MCP Sunucusu Araçları (2/4)

· Özellikler

sgcWebSockets 2025.9.0 sürümüyle geliştiriciler artık Model Context Protocol (MCP) işlevselliğini doğrudan sunucularına entegre edebilir. Buna, yapay zeka modelleri ile arka uç hizmetleri arasında dinamik ve akıllı iletişimi sağlamanın temel bir bileşeni olan MCP Araç İsteklerini (Tool Requests) işleme yeteneği dahildir.

Bu kılavuz, MCP Araç İsteklerinin nasıl çalıştığını, bunları TsgcWSAPIServer_MCP sunucunuzda nasıl işleyeceğinizi ve istemciye veya yapay zeka aracısına yapılandırılmış yanıtları nasıl geri göndereceğinizi adım adım anlatacaktır. 

MCP Araç İsteklerini Anlama

MCP (Model Context Protocol) ekosisteminde, Araçlar (Tools), bir yapay zeka modelinin çağırabileceği yetenekleri temsil eder; örneğin bir veritabanını sorgulamak, bir e-posta göndermek veya bir API'den veri almak.

Bir MCP sunucusu bu araçları WebSockets aracılığıyla sunar ve istemciler (yapay zeka aracıları gibi) belirli eylemleri tetiklemek için Araç İstekleri yapabilir. sgcWebSockets'teki TsgcWSAPIServer_MCP bileşeni, MCP mesajlarını otomatik olarak çözüp sunucunuzdaki uygun olay işleyicilerine yönlendirerek tüm akışı basitleştirir. 

MCP Araç İstekleri Nasıl Çalışır

İletişim akışı tipik olarak şöyle görünür:

  1. İstemci, MCP sunucusuna bir Araç İsteği gönderir (JSON formatında MCP mesajı).
  2. sgcWebSockets isteği ayrıştırır ve OnToolRequest gibi bir olayı tetikler.
  3. Sunucu, istenen eylemi gerçekleştirir; örneğin bir CRM'den okur, bir veritabanını sorgular veya bir hesaplama yapar.
  4. Sunucu, MCP formatında bir yanıt oluşturur (herhangi bir sonuç verisi veya hata dahil).
  5. Yanıt, istekte bulunan istemciye geri gönderilir.

Her MCP Araç İsteği şunlarla tanımlanır:

Delphi'de Araç İsteklerini İşleme

MCP sunucunuzu TsgcWSAPIServer_MCP kullanarak yapılandırdıktan sonra, gelen araç isteklerini olay işleyicileri aracılığıyla işleyebilirsiniz.
Aşağıda, gelen MCP Araç İstekleri için bir işleyicinin nasıl uygulanacağına dair bir örnek bulunmaktadır. 

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;

MCP Araç Meta Verilerini Kullanma

Ayrıca, MCP API'sini kullanarak mevcut araçlar hakkındaki meta verileri kaydedebilir ve sunabilirsiniz.
Bu, yapay zeka modellerinin mevcut araçlarınızı dinamik olarak keşfetmesine ve beklenen parametrelerini anlamasına olanak tanır.

Örneğin, şunu bildirebilirsiniz: 

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;

Bu bilgi, yapay zeka istemcilerinin araçlarınızı nasıl çağıracağını otomatik olarak anlamasına yardımcı olur ve kendi kendini belgeleyen yapay zeka entegrasyonları oluşturmayı kolaylaştırır. 

Özet

sgcWebSockets 2025.9.0 sürümündeki MCP Araç İstekleri, yapay zeka modellerinizi gerçek dünya sistemleriyle bağlamanın basit ama güçlü bir yolunu sağlar.
TsgcWSAPIServer_MCP bileşenini ve yerleşik Araç İsteği işlemesini kullanarak şunları yapabilirsiniz:

Daha Fazla Bilgi

MCP API'sine ve mevcut sunucu bileşenlerine daha derinlemesine bir bakış için resmi belgeleri ziyaret edin:


👉 sgcWebSockets MCP Tools Server Referansı 


Aşağıda Windows için bir Delphi MCP Sunucusu Demosu bulabilirsiniz.