Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Orodja, viri in pozivi v MCP

Lekcija 3 od 14 Posodobljeno 2. november 2026 Razvijalec
Na tej strani
  1. Tri zmogljivosti, trije nameni
  2. Orodja: izvedljive funkcije
  3. Viri: berljivi podatki
  4. Pozivi: ponovno uporabne predloge
  5. Pogajanje o zmogljivostih
  6. Koliko orodij na strežnik?
  7. Ključne ugotovitve

Posodobljeno 2. novembra 2026 — MCP Python SDK v2. Ta tečaj zdaj sledi različici 2 SDK-ja mcp (2.3.0 z dne 2. oktobra 2026): MCPServer nadomešča FastMCP, nastavitve prenosa se premaknejo v run() ali streamable_http_app(), aplikacija, izpostavljena pod realnim gostiteljskim imenom, pa mora to ime deklarirati (transport_security). To je tudi različica, ki jo zahteva Mistral SDK: dodatek mistralai[agents] zahteva mcp>=2.2.0,<3.0. Viri: Kaj je novega v v2 · Vodnik za selitev · Uvajanje in skaliranje.

Tri zmogljivosti, trije nameni

Strežnik MCP lahko svojim odjemalcem izpostavi tri vrste zmogljivosti. Niso zamenljive: vsaka naslavlja drugačno potrebo, zamenjava med njimi pa vodi do strežnikov, ki jih model težko uporablja. V tej lekciji jih bomo obravnavali eno za drugo, preden se lotimo vprašanja, ki določa kakovost strežnika: koliko orodij in na kakšni ravni podrobnosti.

Orodja: izvedljive funkcije

Orodja so najbolj uporabljena zmogljivost protokola. Orodje je funkcija, ki jo model lahko sklene poklicati za izvedbo dejanja ali pridobitev informacij. Njegova definicija temelji na štirih elementih: edinstveno, opisno ime (create_issue, get_weather), besedilni opis, ki modelu pove, kdaj naj ga pokliče, shema JSON za vhodne parametre z njihovimi tipi in omejitvami ter format vračanja – najpogosteje besedilo ali JSON.

from mcp.server.mcpserver import MCPServer

app = MCPServer("My Server")

@app.tool()
def get_weather(latitude: float, longitude: float) -> str:
    """Retrieves current weather for the given coordinates.

    Args:
        latitude: Latitude in decimal degrees (-90 to 90)
        longitude: Longitude in decimal degrees (-180 to 180)

    Returns:
        Text description of current weather
    """
    # Weather API call logic
    return f"Sunny, 22°C at ({latitude}, {longitude})"

Ne podcenjuj opisa in tipizacije: model ne vidi ničesar drugega. Nima dostopa do tvoje kode, ne more uganiti tvojih namenov in ne more preizkusiti klica, da bi videl, kaj se zgodi. Nejasni opisi ali slabo tipizirani parametri mehansko povzročijo napačne klice.

Nekaj navad bo tvoja orodja naredilo bistveno zanesljivejša. Poimenuj jih glede na to, kaj počnejo – book_restaurant pove vse, process_request ne pove nič – in opiši tako dejanje kot vsebino odgovora, saj mora model predvideti, kaj bo pridobil. Vedno anotiraj parametre v Pythonu in piši strukturirane docstringe z Args in Returns: ti napajajo shemo, ki jo vidi model. Nazadnje, vračaj berljive vrednosti namesto neprozornih identifikatorjev; orodje, ki vrne "John Smith", modelu omogoča sestavo stavka, medtem ko ga orodje, ki vrne UUID, prisili v ugibanje.

Viri: berljivi podatki

Viri izpostavljajo podatke, ki jih odjemalec lahko bere brez stranskih učinkov. Odtenek glede na orodja se skriva v enem glagolu: orodje nekaj naredi, vir nekaj vsebuje. Vsebina konfiguracijske datoteke, zbirke znanja, dokumentacije API-ja ali trenutno stanje sistema so vse naravni viri.

@app.resource("config://database")
def get_db_config() -> str:
    """Current database configuration."""
    return json.dumps({
        "host": "localhost",
        "port": 5432,
        "database": "production"
    })

Vsak vir je identificiran z URI-jem – config://database, file:///path/to/doc – ki ga odjemalec lahko izpiše in nato bere na zahtevo. V praksi se uporabljajo redkeje kot orodja, saj preprosto orodje, ki vrača podatke, pokriva večino potreb. Ostajajo uporabna, ko želiš objaviti statične ali pol-statične podatke brez logike izvajanja za njimi.

Pozivi: ponovno uporabne predloge

MCP pozivi (Prompts) so parametrizabilne predloge, ki jih strežnik naredi dostopne. Služijo deljenju preizkušenih navodil za določeno nalogo, namesto da bi vsak znova izumljal svoje formulacije.

@app.prompt()
def code_review(language: str, code: str) -> str:
    """Generates a code review prompt for the given language."""
    return f"""You are an expert in {language}.
Analyze the following code and identify:
1. Potential bugs
2. Performance issues
3. Readability improvements

Code to analyze:
```{language}
{code}
```"""

Ta uporaba ima največ smisla v ekipnem okolju. Višji razvijalec kodira svoje pozive za pregled kode, odpravljanje napak ali analizo arhitekture v strežnik MCP, celotna ekipa pa do njih dostopa iz svojih odjemalcev z enako kakovostjo navodil.

Pogajanje o zmogljivostih

Ko se odjemalec poveže s strežnikom, vsaki uporabi sledi faza pogajanj:

  1. Odjemalec zahteva zmogljivosti strežnika
  2. Strežnik odgovori s svojim seznamom orodij, virov in pozivov
  3. Odjemalec te zmogljivosti predstavi jezikovnemu modelu
  4. Model uporabi opise, da se odloči, kaj poklicati

To pogajanje je dinamično in to je lastnost, ki jo lahko izkoristiš: isti strežnik lahko napove različne zmogljivosti glede na povezanega uporabnika ali kontekst klica – administratorski račun vidi orodja, ki jih račun samo za branje nikoli ne bo videl.

Koliko orodij na strežnik?

Vprašanje se zdi trivialno, vendar pogojuje stopnjo napak tvojega agenta. Ohrani svoje strežnike osredotočene: tri do deset dobro opredeljenih orodij deluje bolje kot petdeset generičnih. Določen obseg preseže model razprši svoje izbire in konča s klicem napačnega orodja ali kopičenjem nepotrebnih klicev.

Če je tvoj funkcionalni obseg širok, ga razdeli na več specializiranih strežnikov – enega za operacije Git, enega za upravljanje projektov, enega za nadzor. Odjemalec zna vzpostaviti povezavo z več strežniki hkrati in aktivirati le tiste, ki jih zahteva trenutna naloga, kar pomeni nalaganje uporabnega konteksta namesto celotnega kataloga.

Zadnji kompromis si zasluži tvojo pozornost: granularnost. Izpostavitev treh orodij za izpis restavracij, preverjanje razpoložljivosti in nato rezervacijo prisili model k orkestraciji zaporedja s tveganjem napake na vsakem koraku. Eno samo orodje za delovni tok – book_restaurant – zajame celotno zaporedje, zmanjša število krožnih potovanj in premakne poslovno logiko tja, kjer je testabilna: v tvojo kodo.

Ključne ugotovitve

  • Orodja = izvedljiva dejanja (90 % primerov uporabe), zahtevajo natančen opis in tipizacijo
  • Viri = berljivi podatki prek URI-ja, brez stranskih učinkov
  • Pozivi = ponovno uporabne predloge, uporabne za ekipe
  • Ohrani svoje strežnike osredotočene (največ 3–10 orodij)
  • Daj prednost orodjem za delovne tokove pred preveč granularnimi orodji
  • Kakovost opisa določa učinkovitost modela