Skip to content

Latest commit

 

History

History
177 lines (138 loc) · 6.91 KB

README.md

File metadata and controls

177 lines (138 loc) · 6.91 KB

MCP Java Client - Demo Kalkulatora

Ten projekt pokazuje, jak stworzyć klienta Java, który łączy się i współpracuje z serwerem MCP (Model Context Protocol). W tym przykładzie połączymy się z serwerem kalkulatora z Rozdziału 01 i wykonamy różne operacje matematyczne.

Wymagania wstępne

Przed uruchomieniem tego klienta musisz:

  1. Uruchomić Serwer Kalkulatora z Rozdziału 01:

    • Przejdź do katalogu serwera kalkulatora: 03-GettingStarted/01-first-server/solution/java/
    • Zbuduj i uruchom serwer kalkulatora: 
      cd ..\01-first-server\solution\java
.\mvnw clean install -DskipTests
java -jar target\calculator-server-0.0.1-SNAPSHOT.jar
    • Serwer powinien działać pod adresem http://localhost:8080

  2. Mieć zainstalowaną Java 21 lub nowszą

  3. Mieć zainstalowany Maven (dołączony przez Maven Wrapper)

Czym jest SDKClient?

SDKClient to aplikacja Java, która pokazuje, jak:

  • Połączyć się z serwerem MCP za pomocą transportu Server-Sent Events (SSE)
  • Wyświetlić listę dostępnych narzędzi na serwerze
  • Zdalnie wywołać różne funkcje kalkulatora
  • Obsłużyć odpowiedzi i wyświetlić wyniki

Jak to działa

Klient korzysta z frameworka Spring AI MCP, aby:

  1. Nawiązać połączenie: Tworzy klienta WebFlux SSE do połączenia z serwerem kalkulatora
  2. Zainicjalizować klienta: Konfiguruje klienta MCP i ustanawia połączenie
  3. Odkryć narzędzia: Wyświetla wszystkie dostępne operacje kalkulatora
  4. Wykonać operacje: Wywołuje różne funkcje matematyczne na przykładowych danych
  5. Wyświetlić wyniki: Pokazuje rezultaty każdej kalkulacji

Struktura projektu

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

Kluczowe zależności

Projekt korzysta z następujących kluczowych zależności:

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

Ta zależność dostarcza:

  • McpClient - główny interfejs klienta
  • WebFluxSseClientTransport - transport SSE do komunikacji webowej
  • Schematy protokołu MCP oraz typy zapytań/odpowiedzi

Budowanie projektu

Zbuduj projekt za pomocą Maven wrappera:

.\mvnw clean install

Uruchamianie klienta

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

Uwaga: Upewnij się, że serwer kalkulatora działa pod adresem http://localhost:8080 przed wykonaniem tych poleceń.

Co robi klient

Po uruchomieniu klient:

  1. Łączy się z serwerem kalkulatora pod adresem http://localhost:8080
  2. Wyświetla narzędzia - pokazuje wszystkie dostępne operacje kalkulatora
  3. Wykonuje obliczenia:
    • Dodawanie: 5 + 3 = 8
    • Odejmowanie: 10 - 4 = 6
    • Mnożenie: 6 × 7 = 42
    • Dzielenie: 20 ÷ 4 = 5
    • Potęgowanie: 2^8 = 256
    • Pierwiastek kwadratowy: √16 = 4
    • Wartość bezwzględna: |-5.5| = 5.5
    • Pomoc: pokazuje dostępne operacje

Oczekiwany wynik

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]

Uwaga: Możesz zobaczyć ostrzeżenia Maven o pozostających wątkach na końcu - jest to normalne w aplikacjach reaktywnych i nie oznacza błędu.

Zrozumienie kodu

1. Konfiguracja transportu

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

Tworzy transport SSE (Server-Sent Events), który łączy się z serwerem kalkulatora.

2. Tworzenie klienta

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

Tworzy synchronicznego klienta MCP i inicjalizuje połączenie.

3. Wywoływanie narzędzi

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

Wywołuje narzędzie "add" z parametrami a=5.0 i b=3.0.

Rozwiązywanie problemów

Serwer nie działa

Jeśli pojawią się błędy połączenia, upewnij się, że serwer kalkulatora z Rozdziału 01 jest uruchomiony:

Error: Connection refused

Rozwiązanie: Najpierw uruchom serwer kalkulatora.

Port jest zajęty

Jeśli port 8080 jest zajęty:

Error: Address already in use

Rozwiązanie: Zatrzymaj inne aplikacje korzystające z portu 8080 lub zmień port serwera na inny.

Błędy podczas budowania

Jeśli pojawią się błędy podczas budowania:

.\mvnw clean install -DskipTests

Dowiedz się więcej

Zastrzeżenie:
Niniejszy dokument został przetłumaczony przy użyciu usługi tłumaczenia AI Co-op Translator. Chociaż dokładamy starań, aby tłumaczenie było jak najbardziej precyzyjne, prosimy mieć na uwadze, że automatyczne tłumaczenia mogą zawierać błędy lub nieścisłości. Oryginalny dokument w języku źródłowym powinien być uznawany za źródło autorytatywne. W przypadku informacji o kluczowym znaczeniu zalecane jest skorzystanie z profesjonalnego tłumaczenia wykonanego przez człowieka. Nie ponosimy odpowiedzialności za jakiekolwiek nieporozumienia lub błędne interpretacje wynikające z korzystania z tego tłumaczenia.