Skip to content

README.md

Latest commit

 

History

History
168 lines (129 loc) · 6.38 KB

README.md

File metadata and controls

168 lines (129 loc) · 6.38 KB

MCP Java Client - Hesap Makinesi Demo

Bu proje, bir MCP (Model Context Protocol) sunucusuna bağlanan ve onunla etkileşime giren bir Java istemcisinin nasıl oluşturulacağını gösterir. Bu örnekte, Bölüm 01'deki hesap makinesi sunucusuna bağlanacak ve çeşitli matematiksel işlemler yapacağız.

Ön Koşullar

Bu istemciyi çalıştırmadan önce şunları yapmanız gerekir:

  1. Bölüm 01'deki Hesap Makinesi Sunucusunu Başlatın:

    • Hesap makinesi sunucusu dizinine gidin: 03-GettingStarted/01-first-server/solution/java/
    • Hesap makinesi sunucusunu derleyip çalıştırın: 
      cd ..\01-first-server\solution\java
.\mvnw clean install -DskipTests
java -jar target\calculator-server-0.0.1-SNAPSHOT.jar
    • Sunucu http://localhost:8080 adresinde çalışıyor olmalı

  2. Sisteminizde Java 21 veya üzeri yüklü olmalı

  3. Maven (Maven Wrapper ile dahil edilmiştir)

SDKClient Nedir?

SDKClient, aşağıdakileri gösteren bir Java uygulamasıdır:

  • MCP sunucusuna Server-Sent Events (SSE) taşıma yöntemiyle bağlanma
  • Sunucudan mevcut araçları listeleme
  • Çeşitli hesap makinesi fonksiyonlarını uzaktan çağırma
  • Yanıtları işleyip sonuçları gösterme

Nasıl Çalışır

İstemci, Spring AI MCP çerçevesini kullanarak:

  1. Bağlantı Kurar: Hesap makinesi sunucusuna bağlanmak için WebFlux SSE istemci taşımasını oluşturur
  2. İstemciyi Başlatır: MCP istemcisini ayarlar ve bağlantıyı kurar
  3. Araçları Keşfeder: Mevcut tüm hesap makinesi işlemlerini listeler
  4. İşlemleri Yürütür: Örnek verilerle çeşitli matematiksel fonksiyonları çağırır
  5. Sonuçları Gösterir: Her hesaplamanın sonucunu ekranda gösterir

Proje Yapısı

src/
└── main/
    └── java/
        └── com/
            └── microsoft/
                └── mcp/
                    └── sample/
                        └── client/
                            └── SDKClient.java    # Main client implementation

Temel Bağımlılıklar

Proje aşağıdaki temel bağımlılıkları kullanır:

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-starter-mcp-server-webflux</artifactId>
</dependency>

Bu bağımlılık şunları sağlar:

  • McpClient - Ana istemci arayüzü
  • WebFluxSseClientTransport - Web tabanlı iletişim için SSE taşıması
  • MCP protokol şemaları ve istek/yanıt tipleri

Projeyi Derleme

Projeyi Maven wrapper ile derleyin:

.\mvnw clean install

İstemciyi Çalıştırma

java -jar .\target\calculator-client-0.0.1-SNAPSHOT.jar

Not: Bu komutları çalıştırmadan önce hesap makinesi sunucusunun http://localhost:8080 adresinde çalıştığından emin olun.

İstemci Ne Yapar?

İstemciyi çalıştırdığınızda:

  1. http://localhost:8080 adresindeki hesap makinesi sunucusuna bağlanır
  2. Araçları Listeler - Mevcut tüm hesap makinesi işlemlerini gösterir
  3. Hesaplamalar Yapar:
    • Toplama: 5 + 3 = 8
    • Çıkarma: 10 - 4 = 6
    • Çarpma: 6 × 7 = 42
    • Bölme: 20 ÷ 4 = 5
    • Üs Alma: 2^8 = 256
    • Karekök: √16 = 4
    • Mutlak Değer: |-5.5| = 5.5
    • Yardım: Mevcut işlemleri gösterir

Beklenen Çıktı

Available Tools = ListToolsResult[tools=[Tool[name=add, description=Add two numbers together, ...], ...]]
Add Result = CallToolResult[content=[TextContent[text="5,00 + 3,00 = 8,00"]], isError=false]
Subtract Result = CallToolResult[content=[TextContent[text="10,00 - 4,00 = 6,00"]], isError=false]
Multiply Result = CallToolResult[content=[TextContent[text="6,00 * 7,00 = 42,00"]], isError=false]
Divide Result = CallToolResult[content=[TextContent[text="20,00 / 4,00 = 5,00"]], isError=false]
Power Result = CallToolResult[content=[TextContent[text="2,00 ^ 8,00 = 256,00"]], isError=false]
Square Root Result = CallToolResult[content=[TextContent[text="√16,00 = 4,00"]], isError=false]
Absolute Result = CallToolResult[content=[TextContent[text="|-5,50| = 5,50"]], isError=false]
Help = CallToolResult[content=[TextContent[text="Basic Calculator MCP Service\n\nAvailable operations:\n1. add(a, b) - Adds two numbers\n2. subtract(a, b) - Subtracts the second number from the first\n..."]], isError=false]

Not: Sonunda Maven tarafından bazı uyarılar görebilirsiniz; bu, reaktif uygulamalar için normaldir ve hata anlamına gelmez.

Kodu Anlama

1. Taşıma Ayarı

var transport = new WebFluxSseClientTransport(WebClient.builder().baseUrl("http://localhost:8080"));

Bu, hesap makinesi sunucusuna bağlanan bir SSE (Server-Sent Events) taşıması oluşturur.

2. İstemci Oluşturma

var client = McpClient.sync(this.transport).build();
client.initialize();

Eşzamanlı bir MCP istemcisi oluşturur ve bağlantıyı başlatır.

3. Araçları Çağırma

CallToolResult resultAdd = client.callTool(new CallToolRequest("add", Map.of("a", 5.0, "b", 3.0)));

"a=5.0" ve "b=3.0" parametreleriyle "add" aracını çağırır.

Sorun Giderme

Sunucu Çalışmıyor

Bağlantı hatası alırsanız, Bölüm 01'deki hesap makinesi sunucusunun çalıştığından emin olun:

Error: Connection refused

Çözüm: Önce hesap makinesi sunucusunu başlatın.

Port Zaten Kullanımda

Eğer 8080 portu meşgulse:

Error: Address already in use

Çözüm: 8080 portunu kullanan diğer uygulamaları durdurun veya sunucuyu farklı bir portta çalışacak şekilde değiştirin.

Derleme Hataları

Derleme hatası alırsanız:

.\mvnw clean install -DskipTests

Daha Fazla Bilgi

Feragatname:
Bu belge, AI çeviri servisi Co-op Translator kullanılarak çevrilmiştir. Doğruluk için çaba göstersek de, otomatik çevirilerin hatalar veya yanlışlıklar içerebileceğini lütfen unutmayın. Orijinal belge, kendi dilinde yetkili kaynak olarak kabul edilmelidir. Kritik bilgiler için profesyonel insan çevirisi önerilir. Bu çevirinin kullanımı sonucu ortaya çıkabilecek yanlış anlamalar veya yorum hatalarından sorumlu değiliz.