Skip to content

README.md

Latest commit

 

History

History
177 lines (138 loc) · 9.28 KB

README.md

File metadata and controls

177 lines (138 loc) · 9.28 KB

MCP Java Client - Демонстрация на калкулатор

Този проект показва как да се създаде Java клиент, който се свързва и взаимодейства със сървър MCP (Model Context Protocol). В този пример ще се свържем със сървъра на калкулатора от Глава 01 и ще извършим различни математически операции.

Предварителни изисквания

Преди да стартирате този клиент, трябва да:

  1. Стартирате сървъра на калкулатора от Глава 01:

    • Отидете в директорията на сървъра на калкулатора: 03-GettingStarted/01-first-server/solution/java/
    • Компилирайте и стартирайте сървъра на калкулатора: 
      cd ..\01-first-server\solution\java
.\mvnw clean install -DskipTests
java -jar target\calculator-server-0.0.1-SNAPSHOT.jar
    • Сървърът трябва да работи на http://localhost:8080

  2. Инсталиран Java 21 или по-нова версия на вашата система

  3. Maven (включен чрез Maven Wrapper)

Какво е SDKClient?

SDKClient е Java приложение, което демонстрира как да:

  • Свържете се със сървър MCP чрез Server-Sent Events (SSE) транспорт
  • Изведете списък с наличните инструменти от сървъра
  • Извикате различни функции на калкулатора дистанционно
  • Обработите отговорите и покажете резултатите

Как работи

Клиентът използва Spring AI MCP framework, за да:

  1. Установи връзка: Създава WebFlux SSE клиентски транспорт за връзка със сървъра на калкулатора
  2. Инициализира клиента: Настройва MCP клиента и установява връзката
  3. Открие инструменти: Извежда всички налични операции на калкулатора
  4. Изпълни операции: Извиква различни математически функции с примерни данни
  5. Покажи резултати: Показва резултатите от всяко изчисление

Структура на проекта

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

Основни зависимости

Проектът използва следните основни зависимости:

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

Тази зависимост предоставя:

  • McpClient - Основният клиентски интерфейс
  • WebFluxSseClientTransport - SSE транспорт за уеб комуникация
  • MCP протоколни схеми и типове за заявки/отговори

Компилиране на проекта

Компилирайте проекта с помощта на Maven wrapper:

.\mvnw clean install

Стартиране на клиента

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

Забележка: Уверете се, че сървърът на калкулатора работи на http://localhost:8080 преди да изпълните някоя от тези команди.

Какво прави клиентът

Когато стартирате клиента, той ще:

  1. Свърже се със сървъра на калкулатора на http://localhost:8080
  2. Изведе списък с инструменти - Показва всички налични операции на калкулатора
  3. Извърши изчисления:
    • Събиране: 5 + 3 = 8
    • Изваждане: 10 - 4 = 6
    • Умножение: 6 × 7 = 42
    • Деление: 20 ÷ 4 = 5
    • Степенуване: 2^8 = 256
    • Квадратен корен: √16 = 4
    • Абсолютна стойност: |-5.5| = 5.5
    • Помощ: Показва наличните операции

Очакван изход

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]

Забележка: Може да видите предупреждения от Maven за останали нишки в края - това е нормално за реактивни приложения и не означава грешка.

Разбиране на кода

1. Настройка на транспорта

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

Това създава SSE (Server-Sent Events) транспорт, който се свързва със сървъра на калкулатора.

2. Създаване на клиента

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

Създава синхронен MCP клиент и инициализира връзката.

3. Извикване на инструменти

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

Извиква инструмента "add" с параметри a=5.0 и b=3.0.

Отстраняване на проблеми

Сървърът не работи

Ако получите грешки при свързване, уверете се, че сървърът на калкулатора от Глава 01 работи:

Error: Connection refused

Решение: Стартирайте първо сървъра на калкулатора.

Портът вече е зает

Ако порт 8080 е зает:

Error: Address already in use

Решение: Затворете други приложения, които използват порт 8080, или променете сървъра да използва друг порт.

Грешки при компилиране

Ако срещнете грешки при компилиране:

.\mvnw clean install -DskipTests

Научете повече

Отказ от отговорност:
Този документ е преведен с помощта на AI преводаческа услуга Co-op Translator. Въпреки че се стремим към точност, моля, имайте предвид, че автоматизираните преводи могат да съдържат грешки или неточности. Оригиналният документ на неговия роден език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Ние не носим отговорност за каквито и да е недоразумения или неправилни тълкувания, произтичащи от използването на този превод.