Почетак рада са MCP-ом

Добродошли у ваше прве кораке са Model Context Protocol-ом (MCP)! Без обзира да ли сте нови у MCP-у или желите да продубите своје разумевање, овај водич ће вас провести кроз основни процес подешавања и развоја. Открићете како MCP омогућава беспрекорну интеграцију између AI модела и апликација, и научити како брзо припремити своје окружење за изградњу и тестирање решења покретаних MCP-ом.

TLDR; Ако правите AI апликације, знате да можете додати алате и друге ресурсе вашем LLM-у (великом језичком моделу), како бисте учинили LLM паметнијим. Међутим, ако те алате и ресурсе поставите на сервер, могућности апликације и сервера могу користити било који клијент са или без LLM-а.

Преглед

Ова лекција пружа практичне смернице за подешавање MCP окружења и изградњу ваших првих MCP апликација. Научићете како да подесите потребне алате и оквире, изградите основне MCP сервере, креирате хост апликације и тестирате своје имплементације.

Model Context Protocol (MCP) је отворени протокол који стандардизује начин на који апликације пружају контекст LLM-овима. Замислите MCP као USB-C порт за AI апликације - он пружа стандардизован начин повезивања AI модела са различитим изворима података и алатима.

Циљеви учења

До краја ове лекције, моћи ћете да:

Подесите развојна окружења за MCP у C#, Java, Python, TypeScript и Rust
Изградите и распоредите основне MCP сервере са прилагођеним функцијама (ресурси, упити и алати)
Креирате хост апликације које се повезују са MCP серверима
Тестирате и отклањате грешке у MCP имплементацијама

Подешавање вашег MCP окружења

Пре него што почнете да радите са MCP-ом, важно је да припремите своје развојно окружење и разумете основни ток рада. Овај одељак ће вас провести кроз почетне кораке подешавања како бисте осигурали глатак почетак са MCP-ом.

Предуслови

Пре него што зароните у развој MCP-а, уверите се да имате:

Развојно окружење: За изабрани језик (C#, Java, Python, TypeScript или Rust)
IDE/Уређивач: Visual Studio, Visual Studio Code, IntelliJ, Eclipse, PyCharm или било који модеран уређивач кода
Менаџери пакета: NuGet, Maven/Gradle, pip, npm/yarn или Cargo
API кључеве: За било које AI услуге које планирате да користите у вашим хост апликацијама

Основна структура MCP сервера

MCP сервер обично укључује:

Конфигурацију сервера: Подешавање порта, аутентификације и других опција
Ресурсе: Податке и контекст доступне LLM-овима
Алате: Функционалности које модели могу позивати
Упите: Шаблоне за генерисање или структурирање текста

Ево поједностављеног примера у TypeScript-у:

import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

// Креирај MCP сервер
const server = new McpServer({
  name: "Demo",
  version: "1.0.0"
});

// Додај алат за сабирање
server.tool("add",
  { a: z.number(), b: z.number() },
  async ({ a, b }) => ({
    content: [{ type: "text", text: String(a + b) }]
  })
);

// Додај динамички ресурс за поздрав
server.resource(
  "file",
  // Параметар 'list' контролише како ресурс приказује доступне фајлове. Постављање на undefined онемогућава приказивање листе за овај ресурс.
  new ResourceTemplate("file://{path}", { list: undefined }),
  async (uri, { path }) => ({
    contents: [{
      uri: uri.href,
      text: `File, ${path}!`
    }]
  })
);

// Додај ресурс за фајл који чита садржај фајла
server.resource(
  "file",
  new ResourceTemplate("file://{path}", { list: undefined }),
  async (uri, { path }) => {
    let text;
    try {
      text = await fs.readFile(path, "utf8");
    } catch (err) {
      text = `Error reading file: ${err.message}`;
    }
    return {
      contents: [{
        uri: uri.href,
        text
      }]
    };
  }
);

server.prompt(
  "review-code",
  { code: z.string() },
  ({ code }) => ({
    messages: [{
      role: "user",
      content: {
        type: "text",
        text: `Please review this code:\n\n${code}`
      }
    }]
  })
);

// Почни са примањем порука на stdin и слањем порука на stdout
const transport = new StdioServerTransport();
await server.connect(transport);

У претходном коду ми смо:

Увезли потребне класе из MCP TypeScript SDK-а.
Креирали и конфигурисали нову инстанцу MCP сервера.
Регистровали прилагођени алат (calculator) са функцијом обраде.
Покренули сервер да слуша долазне MCP захтеве.

Тестирање и отклањање грешака

Пре него што почнете да тестирате свој MCP сервер, важно је да разумете доступне алате и најбоље праксе за отклањање грешака. Ефикасно тестирање осигурава да ваш сервер ради како се очекује и помаже вам да брзо идентификујете и решите проблеме. Следећи одељак описује препоручене приступе за валидацију ваше MCP имплементације.

MCP пружа алате који вам помажу да тестирате и отклањате грешке на вашим серверима:

Inspector алат, ова графичка интерфејс вам омогућава да се повежете на свој сервер и тестирате своје алате, упите и ресурсе.
curl, такође можете да се повежете на свој сервер користећи командну линију као што је curl или друге клијенте који могу креирати и извршавати HTTP команде.

Коришћење MCP Inspectora

MCP Inspector је визуелни алат за тестирање који вам помаже да:

Откријете могућности сервера: Аутоматски детектује доступне ресурсе, алате и упите
Тестирате извршење алата: Испробајте различите параметре и видите одговоре у реалном времену
Погледате метаподатке сервера: Испитајте информације о серверу, шеме и конфигурације

# пример TypeScript-а, инсталирање и покретање MCP инспектора
npx @modelcontextprotocol/inspector node build/index.js

Када покренете горе наведене команде, MCP Inspector ће покренути локални веб интерфејс у вашем прегледачу. Можете очекивати да видите контролну таблу која приказује ваше регистроване MCP сервере, њихове доступне алате, ресурсе и упите. Интерфејс вам омогућава интерактивно тестирање извршења алата, преглед метаподатака сервера и приказ одговора у реалном времену, што олакшава валидацију и отклањање грешака у вашим MCP сервер имплементацијама.

Ево снимка екрана како то може изгледати:

Чести проблеми при подешавању и решења

Проблем	Могуће решење
Веза одбијена	Проверите да ли сервер ради и да ли је порт исправан
Грешке при извршењу алата	Прегледајте валидацију параметара и обраду грешака
Неуспех аутентификације	Проверите API кључеве и дозволе
Грешке валидације шеме	Уверите се да параметри одговарају дефинисаној шеми
Сервер се не покреће	Проверите конфликте портова или недостајуће зависности
CORS грешке	Конфигуришите исправне CORS заглавља за захтеве из других домена
Проблеми са аутентификацијом	Проверите ваљаност токена и дозволе

Локални развој

За локални развој и тестирање, можете покренути MCP сервере директно на свом рачунару:

Покрените серверски процес: Покрените своју MCP сервер апликацију
Конфигуришите мрежу: Уверите се да је сервер доступан на очекиваном порту
Повежите клијенте: Користите локалне URL адресе као што је http://localhost:3000

# Пример: Покретање TypeScript MCP сервера локално
npm run start
# Сервер ради на http://localhost:3000

Изградња вашег првог MCP сервера

Покрили смо Основне концепте у претходној лекцији, сада је време да то знање применимо.

Шта сервер може да ради

Пре него што почнемо да пишемо код, подсетимо се шта сервер може да ради:

MCP сервер може, на пример:

Приступати локалним фајловима и базама података
Повезивати се на удаљене API-је
Извршавати прорачуне
Интегрисати се са другим алатима и услугама
Пружати кориснички интерфејс за интеракцију

Одлично, сада када знамо шта можемо да урадимо, хајде да почнемо са кодирањем.

Вежба: Креирање сервера

Да бисте креирали сервер, потребно је да следите ове кораке:

Инсталирајте MCP SDK.
Креирајте пројекат и подесите структуру пројекта.
Напишите серверски код.
Тестирајте сервер.

-1- Креирање пројекта

TypeScript

# Креирајте директоријум пројекта и иницијализујте npm пројекат
mkdir calculator-server
cd calculator-server
npm init -y

Python

# Креирајте директоријум пројекта
mkdir calculator-server
cd calculator-server
# Отворите фасциклу у Visual Studio Code - Прескочите ово ако користите други IDE
code .

.NET

dotnet new console -n McpCalculatorServer
cd McpCalculatorServer

Java

За Java, креирајте Spring Boot пројекат:

curl https://start.spring.io/starter.zip \
  -d dependencies=web \
  -d javaVersion=21 \
  -d type=maven-project \
  -d groupId=com.example \
  -d artifactId=calculator-server \
  -d name=McpServer \
  -d packageName=com.microsoft.mcp.sample.server \
  -o calculator-server.zip

Распакујте zip фајл:

unzip calculator-server.zip -d calculator-server
cd calculator-server
# опционално уклоните неискоришћени тест
rm -rf src/test/java

Додајте следећу комплетну конфигурацију у ваш pom.xml фајл:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    
    <!-- Spring Boot parent for dependency management -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.5.0</version>
        <relativePath />
    </parent>

    <!-- Project coordinates -->
    <groupId>com.example</groupId>
    <artifactId>calculator-server</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>Calculator Server</name>
    <description>Basic calculator MCP service for beginners</description>

    <!-- Properties -->
    <properties>
        <java.version>21</java.version>
        <maven.compiler.source>21</maven.compiler.source>
        <maven.compiler.target>21</maven.compiler.target>
    </properties>

    <!-- Spring AI BOM for version management -->
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.ai</groupId>
                <artifactId>spring-ai-bom</artifactId>
                <version>1.0.0-SNAPSHOT</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <!-- Dependencies -->
    <dependencies>
        <dependency>
            <groupId>org.springframework.ai</groupId>
            <artifactId>spring-ai-starter-mcp-server-webflux</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-actuator</artifactId>
        </dependency>
        <dependency>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter-test</artifactId>
         <scope>test</scope>
      </dependency>
    </dependencies>

    <!-- Build configuration -->
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <release>21</release>
                </configuration>
            </plugin>
        </plugins>
    </build>

    <!-- Repositories for Spring AI snapshots -->
    <repositories>
        <repository>
            <id>spring-milestones</id>
            <name>Spring Milestones</name>
            <url>https://repo.spring.io/milestone</url>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </repository>
        <repository>
            <id>spring-snapshots</id>
            <name>Spring Snapshots</name>
            <url>https://repo.spring.io/snapshot</url>
            <releases>
                <enabled>false</enabled>
            </releases>
        </repository>
    </repositories>
</project>

Rust

mkdir calculator-server
cd calculator-server
cargo init

-2- Додавање зависности

Сада када сте креирали пројекат, додајмо зависности:

TypeScript

# Ако већ није инсталиран, инсталирајте TypeScript глобално
npm install typescript -g

# Инсталирајте MCP SDK и Zod за валидацију шеме
npm install @modelcontextprotocol/sdk zod
npm install -D @types/node typescript

Python

# Креирај виртуелно окружење и инсталирај зависности
python -m venv venv
venv\Scripts\activate
pip install "mcp[cli]"

Java

cd calculator-server
./mvnw clean install -DskipTests

Rust

cargo add rmcp --features server,transport-io
cargo add serde
cargo add tokio --features rt-multi-thread

-3- Креирање фајлова пројекта

TypeScript

Отворите package.json фајл и замените садржај следећим како бисте осигурали да можете да градите и покрећете сервер:

{
  "name": "calculator-server",
  "version": "1.0.0",
  "main": "index.js",
  "type": "module",
  "scripts": {
    "build": "tsc",
    "start": "npm run build && node ./build/index.js",
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "description": "A simple calculator server using Model Context Protocol",
  "dependencies": {
    "@modelcontextprotocol/sdk": "^1.16.0",
    "zod": "^3.25.76"
  },
  "devDependencies": {
    "@types/node": "^24.0.14",
    "typescript": "^5.8.3"
  }
}

Креирајте tsconfig.json са следећим садржајем:

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "Node16",
    "moduleResolution": "Node16",
    "outDir": "./build",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

Креирајте директоријум за ваш изворни код:

mkdir src
touch src/index.ts

Python

Креирајте фајл server.py

touch server.py

.NET

Инсталирајте потребне NuGet пакете:

dotnet add package ModelContextProtocol --prerelease
dotnet add package Microsoft.Extensions.Hosting

Java

За Java Spring Boot пројекте, структура пројекта се аутоматски креира.

Rust

За Rust, src/main.rs фајл се аутоматски креира када покренете cargo init. Отворите фајл и обришите подразумевани код.

-4- Креирање серверског кода

TypeScript

Креирајте фајл index.ts и додајте следећи код:

import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";
 
// Креирај MCP сервер
const server = new McpServer({
  name: "Calculator MCP Server",
  version: "1.0.0"
});

Сада имате сервер, али он не ради много, хајде да то поправимо.

Python

# server.py
from mcp.server.fastmcp import FastMCP

# Креирај MCP сервер
mcp = FastMCP("Demo")

.NET

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
using ModelContextProtocol.Server;
using System.ComponentModel;

var builder = Host.CreateApplicationBuilder(args);
builder.Logging.AddConsole(consoleLogOptions =>
{
    // Configure all logs to go to stderr
    consoleLogOptions.LogToStandardErrorThreshold = LogLevel.Trace;
});

builder.Services
    .AddMcpServer()
    .WithStdioServerTransport()
    .WithToolsFromAssembly();
await builder.Build().RunAsync();

// add features

Java

За Java, креирајте основне серверске компоненте. Прво, измените главну апликацијску класу:

src/main/java/com/microsoft/mcp/sample/server/McpServerApplication.java:

package com.microsoft.mcp.sample.server;

import org.springframework.ai.tool.ToolCallbackProvider;
import org.springframework.ai.tool.method.MethodToolCallbackProvider;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import com.microsoft.mcp.sample.server.service.CalculatorService;

@SpringBootApplication
public class McpServerApplication {

    public static void main(String[] args) {
        SpringApplication.run(McpServerApplication.class, args);
    }
    
    @Bean
    public ToolCallbackProvider calculatorTools(CalculatorService calculator) {
        return MethodToolCallbackProvider.builder().toolObjects(calculator).build();
    }
}

Креирајте сервис калкулатора src/main/java/com/microsoft/mcp/sample/server/service/CalculatorService.java:

package com.microsoft.mcp.sample.server.service;

import org.springframework.ai.tool.annotation.Tool;
import org.springframework.stereotype.Service;

/**
 * Service for basic calculator operations.
 * This service provides simple calculator functionality through MCP.
 */
@Service
public class CalculatorService {

    /**
     * Add two numbers
     * @param a The first number
     * @param b The second number
     * @return The sum of the two numbers
     */
    @Tool(description = "Add two numbers together")
    public String add(double a, double b) {
        double result = a + b;
        return formatResult(a, "+", b, result);
    }

    /**
     * Subtract one number from another
     * @param a The number to subtract from
     * @param b The number to subtract
     * @return The result of the subtraction
     */
    @Tool(description = "Subtract the second number from the first number")
    public String subtract(double a, double b) {
        double result = a - b;
        return formatResult(a, "-", b, result);
    }

    /**
     * Multiply two numbers
     * @param a The first number
     * @param b The second number
     * @return The product of the two numbers
     */
    @Tool(description = "Multiply two numbers together")
    public String multiply(double a, double b) {
        double result = a * b;
        return formatResult(a, "*", b, result);
    }

    /**
     * Divide one number by another
     * @param a The numerator
     * @param b The denominator
     * @return The result of the division
     */
    @Tool(description = "Divide the first number by the second number")
    public String divide(double a, double b) {
        if (b == 0) {
            return "Error: Cannot divide by zero";
        }
        double result = a / b;
        return formatResult(a, "/", b, result);
    }

    /**
     * Calculate the power of a number
     * @param base The base number
     * @param exponent The exponent
     * @return The result of raising the base to the exponent
     */
    @Tool(description = "Calculate the power of a number (base raised to an exponent)")
    public String power(double base, double exponent) {
        double result = Math.pow(base, exponent);
        return formatResult(base, "^", exponent, result);
    }

    /**
     * Calculate the square root of a number
     * @param number The number to find the square root of
     * @return The square root of the number
     */
    @Tool(description = "Calculate the square root of a number")
    public String squareRoot(double number) {
        if (number < 0) {
            return "Error: Cannot calculate square root of a negative number";
        }
        double result = Math.sqrt(number);
        return String.format("√%.2f = %.2f", number, result);
    }

    /**
     * Calculate the modulus (remainder) of division
     * @param a The dividend
     * @param b The divisor
     * @return The remainder of the division
     */
    @Tool(description = "Calculate the remainder when one number is divided by another")
    public String modulus(double a, double b) {
        if (b == 0) {
            return "Error: Cannot divide by zero";
        }
        double result = a % b;
        return formatResult(a, "%", b, result);
    }

    /**
     * Calculate the absolute value of a number
     * @param number The number to find the absolute value of
     * @return The absolute value of the number
     */
    @Tool(description = "Calculate the absolute value of a number")
    public String absolute(double number) {
        double result = Math.abs(number);
        return String.format("|%.2f| = %.2f", number, result);
    }

    /**
     * Get help about available calculator operations
     * @return Information about available operations
     */
    @Tool(description = "Get help about available calculator operations")
    public String help() {
        return "Basic Calculator MCP Service\n\n" +
               "Available operations:\n" +
               "1. add(a, b) - Adds two numbers\n" +
               "2. subtract(a, b) - Subtracts the second number from the first\n" +
               "3. multiply(a, b) - Multiplies two numbers\n" +
               "4. divide(a, b) - Divides the first number by the second\n" +
               "5. power(base, exponent) - Raises a number to a power\n" +
               "6. squareRoot(number) - Calculates the square root\n" + 
               "7. modulus(a, b) - Calculates the remainder of division\n" +
               "8. absolute(number) - Calculates the absolute value\n\n" +
               "Example usage: add(5, 3) will return 5 + 3 = 8";
    }

    /**
     * Format the result of a calculation
     */
    private String formatResult(double a, String operator, double b, double result) {
        return String.format("%.2f %s %.2f = %.2f", a, operator, b, result);
    }
}

Опционе компоненте за сервис спреман за продукцију:

Креирајте конфигурацију покретања src/main/java/com/microsoft/mcp/sample/server/config/StartupConfig.java:

package com.microsoft.mcp.sample.server.config;

import org.springframework.boot.CommandLineRunner;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class StartupConfig {
    
    @Bean
    public CommandLineRunner startupInfo() {
        return args -> {
            System.out.println("\n" + "=".repeat(60));
            System.out.println("Calculator MCP Server is starting...");
            System.out.println("SSE endpoint: http://localhost:8080/sse");
            System.out.println("Health check: http://localhost:8080/actuator/health");
            System.out.println("=".repeat(60) + "\n");
        };
    }
}

Креирајте контролер здравља src/main/java/com/microsoft/mcp/sample/server/controller/HealthController.java:

package com.microsoft.mcp.sample.server.controller;

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import java.time.LocalDateTime;
import java.util.HashMap;
import java.util.Map;

@RestController
public class HealthController {
    
    @GetMapping("/health")
    public ResponseEntity<Map<String, Object>> healthCheck() {
        Map<String, Object> response = new HashMap<>();
        response.put("status", "UP");
        response.put("timestamp", LocalDateTime.now().toString());
        response.put("service", "Calculator MCP Server");
        return ResponseEntity.ok(response);
    }
}

Креирајте обрађивач изузетака src/main/java/com/microsoft/mcp/sample/server/exception/GlobalExceptionHandler.java:

package com.microsoft.mcp.sample.server.exception;

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(IllegalArgumentException.class)
    public ResponseEntity<ErrorResponse> handleIllegalArgumentException(IllegalArgumentException ex) {
        ErrorResponse error = new ErrorResponse(
            "Invalid_Input", 
            "Invalid input parameter: " + ex.getMessage());
        return new ResponseEntity<>(error, HttpStatus.BAD_REQUEST);
    }

    public static class ErrorResponse {
        private String code;
        private String message;

        public ErrorResponse(String code, String message) {
            this.code = code;
            this.message = message;
        }

        // Гетери
        public String getCode() { return code; }
        public String getMessage() { return message; }
    }
}

Креирајте прилагођени банер src/main/resources/banner.txt:

_____      _            _       _             
 / ____|    | |          | |     | |            
| |     __ _| | ___ _   _| | __ _| |_ ___  _ __ 
| |    / _` | |/ __| | | | |/ _` | __/ _ \| '__|
| |___| (_| | | (__| |_| | | (_| | || (_) | |   
 \_____\__,_|_|\___|\__,_|_|\__,_|\__\___/|_|   
                                                
Calculator MCP Server v1.0
Spring Boot MCP Application

Rust

Додајте следећи код на врх src/main.rs фајла. Ово увози потребне библиотеке и модуле за ваш MCP сервер.

use rmcp::{
    handler::server::{router::tool::ToolRouter, tool::Parameters},
    model::{ServerCapabilities, ServerInfo},
    schemars, tool, tool_handler, tool_router,
    transport::stdio,
    ServerHandler, ServiceExt,
};
use std::error::Error;

Калкулатор сервер ће бити једноставан и моћи ће да сабира два броја. Креирајмо структуру која представља захтев калкулатора.

#[derive(Debug, serde::Deserialize, schemars::JsonSchema)]
pub struct CalculatorRequest {
    pub a: f64,
    pub b: f64,
}

Затим, креирајте структуру која представља калкулатор сервер. Ова структура ће држати рутирање алата, које се користи за регистрацију алата.

#[derive(Debug, Clone)]
pub struct Calculator {
    tool_router: ToolRouter<Self>,
}

Сада можемо имплементирати Calculator структуру да креирамо нову инстанцу сервера и имплементирамо серверски обрађивач који пружа информације о серверу.

#[tool_router]
impl Calculator {
    pub fn new() -> Self {
        Self {
            tool_router: Self::tool_router(),
        }
    }
}

#[tool_handler]
impl ServerHandler for Calculator {
    fn get_info(&self) -> ServerInfo {
        ServerInfo {
            instructions: Some("A simple calculator tool".into()),
            capabilities: ServerCapabilities::builder().enable_tools().build(),
            ..Default::default()
        }
    }
}

Коначно, потребно је да имплементирамо главну функцију која покреће сервер. Ова функција ће креирати инстанцу Calculator структуре и служити је преко стандардног улаза/излаза.

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    let service = Calculator::new().serve(stdio()).await?;
    service.waiting().await?;
    Ok(())
}

Сервер је сада подешен да пружа основне информације о себи. Следеће ћемо додати алат за извођење сабирања.

-5- Додавање алата и ресурса

Додајте алат и ресурс додавањем следећег кода:

TypeScript

server.tool(
  "add",
  { a: z.number(), b: z.number() },
  async ({ a, b }) => ({
    content: [{ type: "text", text: String(a + b) }]
  })
);

server.resource(
  "greeting",
  new ResourceTemplate("greeting://{name}", { list: undefined }),
  async (uri, { name }) => ({
    contents: [{
      uri: uri.href,
      text: `Hello, ${name}!`
    }]
  })
);

Ваш алат узима параметре a и b и извршава функцију која производи одговор у облику:

{
  contents: [{
    type: "text", content: "some content"
  }]
}

Ваш ресурс се приступа кроз стринг "greeting" и узима параметар name и производи сличан одговор као алат:

{
  uri: "<href>",
  text: "a text"
}

Python

# Додај алат за сабирање
@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b


# Додај динамички ресурс за поздрављање
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """Get a personalized greeting"""
    return f"Hello, {name}!"

У претходном коду смо:

Дефинисали алат add који узима параметре a и b, оба целобројна.
Креирали ресурс под називом greeting који узима параметар name.

.NET

Додајте ово у ваш Program.cs фајл:

[McpServerToolType]
public static class CalculatorTool
{
    [McpServerTool, Description("Adds two numbers")]
    public static string Add(int a, int b) => $"Sum {a + b}";
}

Java

Алатке су већ креиране у претходном кораку.

Rust

Додајте нови алат унутар impl Calculator блока:

#[tool(description = "Adds a and b")]
async fn add(
    &self,
    Parameters(CalculatorRequest { a, b }): Parameters<CalculatorRequest>,
) -> String {
    (a + b).to_string()
}

-6- Коначни код

Додајмо последњи код који нам је потребан да сервер може да се покрене:

TypeScript

// Почни са примањем порука на stdin и слањем порука на stdout
const transport = new StdioServerTransport();
await server.connect(transport);

Ево комплетног кода:

// index.ts
import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

// Креирај MCP сервер
const server = new McpServer({
  name: "Calculator MCP Server",
  version: "1.0.0"
});

// Додај алат за сабирање
server.tool(
  "add",
  { a: z.number(), b: z.number() },
  async ({ a, b }) => ({
    content: [{ type: "text", text: String(a + b) }]
  })
);

// Додај динамички ресурс за поздрав
server.resource(
  "greeting",
  new ResourceTemplate("greeting://{name}", { list: undefined }),
  async (uri, { name }) => ({
    contents: [{
      uri: uri.href,
      text: `Hello, ${name}!`
    }]
  })
);

// Почни са примањем порука на stdin и слањем порука на stdout
const transport = new StdioServerTransport();
server.connect(transport);

Python

# server.py
from mcp.server.fastmcp import FastMCP

# Креирај MCP сервер
mcp = FastMCP("Demo")


# Додај алат за сабирање
@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b


# Додај динамички ресурс за поздрав
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """Get a personalized greeting"""
    return f"Hello, {name}!"

# Главни блок извршења - ово је потребно за покретање сервера
if __name__ == "__main__":
    mcp.run()

.NET

Креирајте Program.cs фајл са следећим садржајем:

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
using ModelContextProtocol.Server;
using System.ComponentModel;

var builder = Host.CreateApplicationBuilder(args);
builder.Logging.AddConsole(consoleLogOptions =>
{
    // Configure all logs to go to stderr
    consoleLogOptions.LogToStandardErrorThreshold = LogLevel.Trace;
});

builder.Services
    .AddMcpServer()
    .WithStdioServerTransport()
    .WithToolsFromAssembly();
await builder.Build().RunAsync();

[McpServerToolType]
public static class CalculatorTool
{
    [McpServerTool, Description("Adds two numbers")]
    public static string Add(int a, int b) => $"Sum {a + b}";
}

Java

Ваша комплетна главна апликацијска класа треба да изгледа овако:

// McpServerApplication.java
package com.microsoft.mcp.sample.server;

import org.springframework.ai.tool.ToolCallbackProvider;
import org.springframework.ai.tool.method.MethodToolCallbackProvider;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import com.microsoft.mcp.sample.server.service.CalculatorService;

@SpringBootApplication
public class McpServerApplication {

    public static void main(String[] args) {
        SpringApplication.run(McpServerApplication.class, args);
    }
    
    @Bean
    public ToolCallbackProvider calculatorTools(CalculatorService calculator) {
        return MethodToolCallbackProvider.builder().toolObjects(calculator).build();
    }
}

Rust

Коначни код за Rust сервер треба да изгледа овако:

use rmcp::{
    ServerHandler, ServiceExt,
    handler::server::{router::tool::ToolRouter, tool::Parameters},
    model::{ServerCapabilities, ServerInfo},
    schemars, tool, tool_handler, tool_router,
    transport::stdio,
};
use std::error::Error;

#[derive(Debug, serde::Deserialize, schemars::JsonSchema)]
pub struct CalculatorRequest {
    pub a: f64,
    pub b: f64,
}

#[derive(Debug, Clone)]
pub struct Calculator {
    tool_router: ToolRouter<Self>,
}

#[tool_router]
impl Calculator {
    pub fn new() -> Self {
        Self {
            tool_router: Self::tool_router(),
        }
    }
    
    #[tool(description = "Adds a and b")]
    async fn add(
        &self,
        Parameters(CalculatorRequest { a, b }): Parameters<CalculatorRequest>,
    ) -> String {
        (a + b).to_string()
    }
}

#[tool_handler]
impl ServerHandler for Calculator {
    fn get_info(&self) -> ServerInfo {
        ServerInfo {
            instructions: Some("A simple calculator tool".into()),
            capabilities: ServerCapabilities::builder().enable_tools().build(),
            ..Default::default()
        }
    }
}

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    let service = Calculator::new().serve(stdio()).await?;
    service.waiting().await?;
    Ok(())
}

-7- Тестирање сервера

Покрените сервер следећом командом:

TypeScript

npm run build

Python

mcp run server.py

Да бисте користили MCP Inspector, користите mcp dev server.py који аутоматски покреће Inspector и обезбеђује потребан proxy session token. Ако користите mcp run server.py, мораћете ручно да покренете Inspector и конфигуришете везу.

.NET

Уверите се да сте у директоријуму свог пројекта:

cd McpCalculatorServer
dotnet run

Java

./mvnw clean install -DskipTests
java -jar target/calculator-server-0.0.1-SNAPSHOT.jar

Rust

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

cargo fmt
cargo run

-8- Покретање помоћу Inspectora

Inspector је одличан алат који може покренути ваш сервер и омогућити вам интеракцију са њим како бисте тестирали да ли ради. Хајде да га покренемо:

Note

може изгледати другачије у пољу "command" јер садржи команду за покретање сервера са вашим специфичним runtime-ом

TypeScript

npx @modelcontextprotocol/inspector node build/index.js

или га додајте у ваш package.json овако: "inspector": "npx @modelcontextprotocol/inspector node build/index.js" и онда покрените npm run inspector

Python

Python обавија Node.js алат који се зове inspector. Могуће је позвати тај алат овако:

mcp dev server.py

Међутим, он не имплементира све методе доступне на алату, па се препоручује да директно покренете Node.js алат као у наставку:

npx @modelcontextprotocol/inspector mcp run server.py

Ако користите алат или IDE који вам омогућава конфигурисање команди и аргумената за покр побрините се да поставите python у поље Command и server.py као Arguments. Ово осигурава да скрипта ради исправно.

.NET

Побрините се да сте у директоријуму вашег пројекта:

cd McpCalculatorServer
npx @modelcontextprotocol/inspector dotnet run

Java

Уверите се да ваш калкулатор сервер ради Затим покрените инспектор:

npx @modelcontextprotocol/inspector

У веб интерфејсу инспектора:

Изаберите "SSE" као тип транспорта
Поставите URL на: http://localhost:8080/sse
Кликните "Connect"

Сада сте повезани са сервером Секција за тестирање Java сервера је сада завршена

Следећа секција је о интеракцији са сервером.

Требало би да видите следећи кориснички интерфејс:

Повежите се са сервером тако што ћете изабрати дугме Connect Када се повежете са сервером, требало би да видите следеће:

Изаберите "Tools" и "listTools", требало би да се појави "Add", изаберите "Add" и попуните вредности параметара.

Требало би да видите следећи одговор, тј. резултат из "add" алата:

Честитамо, успели сте да креирате и покренете свој први сервер!

Rust

Да бисте покренули Rust сервер са MCP Inspector CLI, користите следећу команду:

npx @modelcontextprotocol/inspector cargo run --cli --method tools/call --tool-name add --tool-arg a=1 b=2

Званични SDK-ови

MCP пружа званичне SDK-ове за више језика:

C# SDK - Одржава се у сарадњи са Microsoft-ом
Java SDK - Одржава се у сарадњи са Spring AI
TypeScript SDK - Званична TypeScript имплементација
Python SDK - Званична Python имплементација
Kotlin SDK - Званична Kotlin имплементација
Swift SDK - Одржава се у сарадњи са Loopwork AI
Rust SDK - Званична Rust имплементација

Кључне поуке

Постављање MCP развојног окружења је једноставно уз SDK-ове специфичне за језик
Креирање MCP сервера укључује креирање и регистрацију алата са јасним шемама
Тестирање и отклањање грешака су неопходни за поуздане MCP имплементације

Примери

Задатак

Креирајте једноставан MCP сервер са алатом по вашем избору:

Имплементирајте алат у вашем омиљеном језику (.NET, Java, Python, TypeScript или Rust).
Дефинишите улазне параметре и повратне вредности.
Покрените инспектор алат да бисте осигурали да сервер ради како је предвиђено.
Тестирајте имплементацију са различитим улазима.

Решење

Solution

Додатни ресурси

Шта следи

Следеће: Getting Started with MCP Clients

Одрицање од одговорности: Овај документ је преведен коришћењем AI услуге за превођење Co-op Translator. Иако се трудимо да превод буде тачан, молимо вас да имате у виду да аутоматски преводи могу садржати грешке или нетачности. Оригинални документ на његовом изворном језику треба сматрати ауторитетним извором. За критичне информације препоручује се професионални људски превод. Нисмо одговорни за било каква неспоразума или погрешна тумачења која произилазе из коришћења овог превода.

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

Почетак рада са MCP-ом

Преглед

Циљеви учења

Подешавање вашег MCP окружења

Предуслови

Основна структура MCP сервера

Тестирање и отклањање грешака

Коришћење MCP Inspectora

Чести проблеми при подешавању и решења

Локални развој

Изградња вашег првог MCP сервера

Шта сервер може да ради

Вежба: Креирање сервера

-1- Креирање пројекта

TypeScript

Python

.NET

Java

Rust

-2- Додавање зависности

TypeScript

Python

Java

Rust

-3- Креирање фајлова пројекта

TypeScript

Python

.NET

Java

Rust

-4- Креирање серверског кода

TypeScript

Python

.NET

Java

Rust

-5- Додавање алата и ресурса

TypeScript

Python

.NET

Java

Rust

-6- Коначни код

TypeScript

Python

.NET

Java

Rust

-7- Тестирање сервера

TypeScript

Python

.NET

Java

Rust

-8- Покретање помоћу Inspectora

TypeScript

Python

.NET

Java

Rust

Званични SDK-ови

Кључне поуке

Примери

Задатак

Решење

Додатни ресурси

Шта следи