Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Ehita ja võta kasutusele oma MCP server

Õppetund 13 / 14 Värskendatud 2. november 2026 Kesktase
Sellel lehel
  1. Ideest tootmisserverini
  2. MCP serveri loomine lokaalselt
  3. Lokaalne testimine
  4. Kasutuselevõtu võimalused
  5. Mitme tööriistaga vs ühe tööriistaga serverid
  6. Keskkonnamuutujate haldamine
  7. Peamised punktid

Uuendus 2. november 2026 — Le Chat on nüüd Vibe. Alates 28. maist 2026 on Le Chat ümber bränditud nimele Vibe (aadressil chat.mistral.ai): üks agent tööks ja kodeerimiseks, kandes üle sinu vestlused, seaded ja tellimused. Vana Le Chati kasutajakogemus on endiselt kättesaadav režiimis Chat; režiimis Work on agentidest saanud oskused (kutsutakse esile sümboliga @), mälud toimivad teadmiste baasina ja süvaotsing on nüüd oskus Deep Research. Plaanid kannavad nüüd nimesid Mistral Free, Pro, Team ja Enterprise. Selles õppetükis kasutame nime Vibe; pane tähele, et mõned siin kirjeldatud menüüd võivad olla muutnud nime või asukohta.

Ideest tootmisserverini

Sa tead, kuidas kasutada olemasolevaid ühendusi ja lisada kohandatud omi. Nüüd on aeg astuda viimane samm: kirjuta oma MCP server ja võta see Vibe’is kasutusele. Käime siin läbi kogu tee, alates esimesest Pythoni failist sinu arvutis kuni tootmismajutuseni, käsitledes disainivalikuid, mis eristavad kasutatavat serverit sellisest, mida mudel kunagi õigesti ei kutsu.

MCP serveri loomine lokaalselt

Teek FastMCP (pip install fastmcp, versioon 4 seisuga november 2026), raamistik, mis on sõltumatu ametlikust mcp SDK-st, taandab serveri loomise paale dekoratsioonile:

from fastmcp import FastMCP

mcp = FastMCP("My Server")

@mcp.tool()
def greet(name: str) -> str:
    """Greets a person by name.

    Args:
        name: The first name of the person to greet.

    Returns:
        A personalized greeting message.
    """
    return f"Hello {name}! Welcome to our platform."

Kõik sõltub nendest paarist reast. Dekoratsioon @mcp.tool() registreerib funktsiooni MCP tööriistana. Dokstringist saab kirjeldus, mida mudel näeb, otsustades, kas tööriista kutsuda – seega pole see kommentaar sinu kolleegidele, vaid funktsionaalne element. Parameetrite tüübid (name: str) ja tagastatava väärtuse tüüp (-> str) annavad mudelile teada oodatavatest tüüpidest ning funktsiooni nimi peab olema selge ja kirjeldav. Ametlik alternatiiv on Anthropicu MCP SDK, saadaval Pythonis ja TypeScriptis: see pakub rohkem kontrolli veidi raskema konfiguratsiooni hinnaga.

Kuna mudel näeb ainult sinu tööriista tekstikirjeldust, kirjuta see nagu täielik kasutusjuhend:

@mcp.tool()
def search_products(
    query: str,
    category: str = "all",
    max_results: int = 10
) -> str:
    """Searches the product catalog.

    Use this tool when the user looks for a product
    by name, SKU, or category.

    Args:
        query: Search terms (product name, SKU, keywords).
        category: Filter category. Possible values: 'all',
                  'electronics', 'clothing', 'food'. Default: 'all'.
        max_results: Maximum number of results to return (1-50).

    Returns:
        List of products with name, price, availability, and SKU.
    """

Pane tähele, mida see dokstring lisab võrreldes eelmisega: kasutustingimus, võimalikud väärtused parameetrile category ja piirangud parameetrile max_results. Harjutuse viimistlevad veel kaks reeglit. Nimed peavad olema eksplitsiitsed – eelista search_products sõnale search, create_invoice sõnale create, get_user_orders sõnale get_data. Ja tagastatav info peab olema loetav: saada tagasi arusaadav tekst, mitte toored ID-d, vastasel juhul ei oska mudel neid loomuliku vastuse formuleerimisel kasutada.

Lokaalne testimine

Kõigepealt käivita server, mis jookseb lokaalsel pordil, vaikimisi localhost:8000:

python server.py

Seejärel tee see avalikuks, et Vibe saaks seda reachida:

ngrok http 8000

ngrok annab avaliku URL-i, näiteks https://abc123.ngrok.io, mida kasutad Vibe’is ühenduse URL-ina – ära unusta lisada lõppu /mcp, et saada täielik lõpp-punkt. Enne Vibe’i sukeldumist valideeri server MCP Inspectoriga:

npx @modelcontextprotocol/inspector

Ühendu oma lokaalse serveriga, loetle tööriistad, testi neid individuaalselt ja kontrolli tagastatavaid väärtusi. See annab teada, kas probleemid tulenevad sinu koodist või sellest, kuidas mudel sinu kirjeldusi tõlgendab.

Kasutuselevõtu võimalused

Kui sinu server on valmis, sõltub majutamine peamiselt sinu piirangutest. Hugging Face Spaces on Mistral AI meeskonna soovitatud tasuta variant: need on virtuaalmasinad, mis majutavad veebirakendusi, täiesti tasuta, kuni sa GPU-d ei vaja. Saad seal seadistada oma MCP serveri FastAPI-ga ja deployida mitu serverit samale Space’ile, igaüks oma lõpp-punktiga – /api1/mcp, /api2/mcp –, mille Vibe lisab eraldi ühendustena. Lisaboonusena ei takista miski sul lisada Space’ile kasutajaliidest, et visualiseerida serveri tegevust.

Prefect Horizon (varem FastMCP Cloud), FastMCP meeskonna platvorm, impordib GitHubi hoidla, mis sisaldab FastMCP serverit, otse: valid hoidla aadressil horizon.prefect.io, platvorm buildib selle ja avaldab autentitud URL-i; isiklike projektide jaoks on olemas tasuta tase. Kergete serverite jaoks, millel pole raskeid sõltuvusi, pakub Cloudflare Workers kiiret ja odavat äärecomputing’u (edge) deployimist. Lõpuks on traditsioonilised pakkujad endiselt täiesti elujõulised meeskondadele, kellel on juba vajalik taristu olemas: AWS (Lambda, ECS), Google Cloud (Cloud Run, Cloud Functions) või Azure (Functions, Container Apps).

Mitme tööriistaga vs ühe tööriistaga serverid

Levinud refleks on jagada tööriistad väga peeneks. Kogemus näitab vastupidist: Mistrali korraldatud MCP hackathonil disainisid parima tulemuse saavutanud meeskonnad kõrgetasemelisi tööriistu, mis vastasid terviklikele töövoogudele. Nad avaldasid book_restaurant asemel, et kasutada list_restaurants + check_availability + make_reservation, või deploy_application asemel, et kasutada build + test + push + deploy. Mudelil on vähem võimalusi jada rikkuda ja kumulatiivne latentsus väheneb vastavalt.

Granulaarsus on siiski mõttekas kolmes olukorras: kui lood üldotstarbelist MCP serverit, mida kasutavad erinevad meeskonnad; kui töövoogu etapid saavad toimida üksteisest sõltumatult; ja kui vajad paindlikkust operatsioonide järjekorras.

Keskkonnamuutujate haldamine

Sinu serveritel on sageli vaja API võtmeid, andmebaasi kasutajatunnuseid või muid salajasi andmeid. Salvesta need süstemaatiliselt keskkonnamuutujatesse, mitte kunagi koodi. Pea eriti meeles, et avalik MCP server ilma autentimiseta võimaldab kõigil tarbida sinu API võtmeid: kaitse seda tokeni või OAuth-iga niipea, kui see kutsub tasulist teenust. Hugging Face Spaces’is on Space’i Secrets mõeldud täpselt selleks.

Peamised punktid

  • FastMCP on lihtsaim viis MCP serveri loomiseks Pythonis
  • Liivi oma tööriistade kirjeldused, nimed ja tüübid
  • Testi esmalt lokaalselt, kasutades ngroki ja MCP Inspectorit enne deployimist
  • Hugging Face Spaces pakub ideaalset tasuta majutust MCP serveritele
  • Eelista töövoogu stiilis tööriistu liiga granulaarsetele
  • Kaitse oma salajasi andmeid ja kaalu autentimist oma serveritele