Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Kurk ir diekite savo MCP serverį

Paskaita 13 iš 14 Atnaujinta 2026 m. lapkričio 2 d. Vidutinis lygis
Šiame puslapyje
  1. Nuo idėjos iki gamybinio serverio
  2. MCP serverio kūrimas lokaliai
  3. Testavimas lokaliai
  4. Diegimo parinktys
  5. Kelių įrankių contra vieno įrankio serveriai
  6. Aplinkos kintamųjų valdymas
  7. Svarbiausi punktai

Atnaujinta 2026 m. lapkričio 2 d. — Le Chat dabar yra Vibe. Nuo 2026 m. gegužės 28 d. Le Chat buvo pervadintas į Vibe (vis dar adresu chat.mistral.ai): tai vienas agentas darbui ir kodui, perkeliantis jūsų pokalbius, nustatymus ir prenumeratas. Senoji Le Chat patirtis vis dar pasiekiama režimu Chat; režimu Work agentai tapo įgūdžiais (kviečiami naudojant @), atmintys veikia kaip žinių bazė, o giluminė paieška dabar yra įgūdis „Deep Research“. Planai dabar vadinami Mistral Free, Pro, Team ir Enterprise. Šioje pamokoje naudojamas pavadinimas Vibe; atkreipkite dėmesį, kad kai kurių čia aprašytų meniu pavadinimai arba vietos galėjo pasikeisti.

Nuo idėjos iki gamybinio serverio

Jau žinai, kaip naudoti esamas jungtis ir pridėti individualių. Dabar metas žengti paskutinį žingsnį: parašyti savo MCP serverį ir jį įdiegti naudojimui Vibe platformoje. Čia nueisime visą kelią – nuo pirmojo Python failo tavo kompiuteryje iki diegimo gamybinėje aplinkoje, aptardami projektavimo sprendimus, kurie atskiria tinkamai veikiantį serverį nuo tokio, kurio modelis niekada teisingai nepakviečia.

MCP serverio kūrimas lokaliai

Biblioteka FastMCP (pip install fastmcp, 2026 m. lapkričio mėn. – 4 versija), nepriklausanti nuo oficialaus mcp SDK, supaprastina serverio kūrimą iki kelių dekoratorių:

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."

Viskas sukasi aplink šias kelias eilutes. Dekoratorius @mcp.tool() registruoja funkciją kaip MCP įrankį. Dokumento eilutė (docstring) tampa aprašymu, kurį modelis mato spręsdamas, ar kviesti įrankį – tai ne komentaras tavo kolegoms, o funkcinis elementas. Parametrų tipai (name: str) ir grąžinamosios reikšmės tipai (-> str) informuoja modelį apie laukiamus duomenų tipus, o funkcijos pavadinimas turi būti aiškus ir aprašomasis. Oficiali alternatyva – Anthropic MCP SDK, prieinama Python ir TypeScript kalbomis: ji suteikia daugiau kontrolės, tačiau reikalauja kiek sudėtingesnės konfigūracijos.

Kadangi modelis mato tik tekstinį tavo įrankio aprašymą, rašyk jį kaip pilną naudotojo vadovą:

@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.
    """

Atkreipk dėmesį, ką šis aprašymas pridėjo, ko trūko ankstesniajam: naudojimo sąlygą, galimas category reikšmes ir max_results ribas. Dar dvi taisyklės užbaigia užduotį. Pavadinimai turi būti aiškūs – rinkis search_products vietoj search, create_invoice vietoj create, get_user_orders vietoj get_data. Grąžinami duomenys turi būti skaitomi: siųsk suprantamą tekstą, o ne žalius ID, kitaip modelis negalės jų panaudoti suformuluodamas natūralų atsakymą.

Testavimas lokaliai

Pirmiausia paleisk serverį, kuris veikia lokaliame prievade, pagal nutylėjimą – localhost:8000:

python server.py

Tada atverk jį, kad Vibe galėtų pasiekti:

ngrok http 8000

ngrok suteikia viešą URL, pavyzdžiui, https://abc123.ngrok.io, kurį naudosite kaip jungties URL Vibe platformoje – nepamirškite pridėti /mcp, kad gautumėte visą galutinį tašką. Prieš pereidami prie Vibe, patikrinkite serverį naudodami MCP Inspector:

npx @modelcontextprotocol/inspector

Prisijunkite prie savo lokalaus serverio, išvardinkite įrankius, ištestuokite juos individualiai ir patikrinkite grąžinamas reikšmes. Tai parodys, ar kylančios problemos kyla iš tavo kodo, ar iš to, kaip modelis interpretuoja tavo aprašymus.

Diegimo parinktys

Kai serveris paruoštas, talpinimas daugiausia priklauso nuo tavo apribojimų. Hugging Face Spaces yra nemokama parinktis, kurią rekomenduoja Mistral AI komanda: tai virtualios mašinos, talpinančios žiniatinklio programas, visiškai nemokamos, kol nereikia GPU. Ten gali nustatyti savo MCP serverį naudodamas FastAPI ir diegti kelis serverius toje pačioje „Space“ erdvėje, kiekvienam suteikdamas savo galutinį tašką – /api1/mcp, /api2/mcp – kuriuos Vibe pridės kaip atskiras jungtis. Papildomas privalumas: niekas netrukdo pridėti sąsajos (frontend) „Space“ erdvei, kad galėtum vizualizuoti savo serverio veiklą.

Prefect Horizon (anksčiau „FastMCP Cloud“), platforma iš FastMCP komandos, tiesiogiai importuoja GitHub saugyklą, kurioje yra FastMCP serveris: pasirenki saugyklą svetainėje horizon.prefect.io, platforma ją sukuria ir paskelbia autentifikacinį URL; asmeniniams projektams yra nemokamas lygmuo. Lengviems serveriams be sunkių priklausomybių Cloudflare Workers siūlo greitą ir pigų diegimą pakraštyje (edge). Galiausiai, tradiciniai tiekėjai lieka puikiai tinkami komandoms, kurios jau turi reikiamą infrastruktūrą: AWS (Lambda, ECS), Google Cloud (Cloud Run, Cloud Functions) arba Azure (Functions, Container Apps).

Kelių įrankių contra vieno įrankio serveriai

Dažnas refleksas – labai smulkiai suskaidyti įrankius. Patirtis rodo priešingai: Mistral organizuotame MCP hakatone geriausiai pasirodžiusios komandos kūrė aukšto lygio įrankius, atitinkančius pilnas darbo eigas. Jos eksponavo book_restaurant vietoj list_restaurants + check_availability + make_reservation, arba deploy_application vietoj build + test + push + deploy. Modelis turi mažiau šansų suklysti vykdant seką, o bendra delsos trukmė atitinkamai sumažėja.

Granuliarumas vis dar turi prasmę trimis atvejais: kai kuriate bendrą MCP serverį, naudojamą skirtingų komandų, kai darbo eigos žingsniai gali būti naudojami nepriklausomai vienas nuo kito ir kai reikia lankstumo operacijų eiliškumui.

Aplinkos kintamųjų valdymas

Tavo serveriams dažnai prireiks API raktų, duomenų bazių prisijungimo duomenų ar kitų paslapčių. Sistemingai saugok juos aplinkos kintamuosiuose, niekada – kode. Ypač atmink, kad viešas MCP serveris be autentifikacijos leidžia bet kam naudoti tavo API raktus: apsaugok jį žetonu arba OAuth, kai tik jis kviečia mokamą paslaugą. Hugging Face Spaces erdvėse tam skirtos specialios Secrets (paslaptys).

Svarbiausi punktai

  • FastMCP yra paprasčiausias būdas sukurti MCP serverį Python kalba
  • Ištobulink savo įrankių aprašymus, pavadinimus ir tipus
  • Pirmiausia testuok lokaliai naudodamas ngrok ir MCP Inspector, prieš diegdamas
  • Hugging Face Spaces siūlo idealų nemokamą talpinimą MCP serveriams
  • Teik pirmenybę darbo eigos stiliaus įrankiams, o ne per daug smulkiems
  • Apsaugok savo paslaptis ir apsvarstyk autentifikaciją savo serveriams