Diegimo į gamybą MCP serverio
Šiame puslapyje
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 „Chat“ režimu; „Work“ režimu agentai dabar yra įgūdžiai (kviečiami naudojant
@), atmintys sudaro žinių bazę, o gilus tyrimas yra „Deep Research“ įgūdis. Planai dabar vadinami „Mistral Free“, „Pro“, „Team“ ir „Enterprise“. Šioje pamokoje naudojamas pavadinimas „Vibe“; kai kurie čia aprašyti meniu pavadinimai arba vietos galėjo pasikeisti.
Atnaujinta 2026 m. lapkričio 2 d. — MCP Python SDK v2. Šis kursas dabar remiasi antrąja
mcpSDK versija (2.3.0 pagal 2026 m. spalio 2 d. duomenis):MCPServerpakeičiaFastMCP, transporto nustatymai perkeliami įrun()arbastreamable_http_app(), o programa, eksponuojama tikruoju prieglobos vardu, privalo deklaruoti tą vardą (transport_security). Tai taip pat yra versija, reikalinga „Mistral SDK“:mistralai[agents]papildinys reikalaujamcp>=2.2.0,<3.0. Šaltiniai: Kas naujo v2 versijoje · Migracijos gidas · Diegimas ir mastelio keitimas.
Nuo prototipo prie gamybinio serverio
Tavo serveris veikia lokaliai, o „ngrok“ jį atveria pasauliui tik demonstracijai. Problema prasideda tada, kai juo turi naudotis kas nors kitas: uždarius terminalą, URL adresas nustoja veikti, ir visi tavo kolegų sukonfigūruoti jungtys sutrinka. Perėjimas prie gamybos iš esmės reiškia stabilaus adreso gavimą, prieinamo 24/7, teikiamo per HTTPS. Yra keturi būdai tai pasiekti – nuo greičiausio iki labiausiai kontroliuojamo. Tavo pasirinkimas daugiausia priklauso nuo to, kiek jautrūs yra tavo duomenys ir kiek kontrolės nori turėti over infrastruktūros.
1 variantas: „Hugging Face Spaces“
„Hugging Face Spaces“ suteikia nemokamas virtualiąsias mašinas be GPU, kurių daugiau nei pakanka MCP serveriui, kuris tik perduoda API užklausas. Tai greičiausias kelias į tikrą diegimą: trys failai ir git push.
mon-mcp-space/
├── app.py # FastAPI + MCP serveris
├── requirements.txt # Priklausomybės
└── README.md # „Space“ metaduomenys
Failas app.py laikosi tikslios iki šiol matytos struktūros, išskyrus tai, kad jautrios reikšmės nuskaitytos iš aplinkos kintamųjų – „HF Secrets“ jas ten įskiepija:
# app.py
"""MCP serveris, diegiamas „Hugging Face Spaces“."""
import os
from contextlib import asynccontextmanager
from fastapi import FastAPI
from mcp.server.mcpserver import MCPServer
from mcp.server.transport_security import TransportSecuritySettings
mcp = MCPServer("My Production Server")
@mcp.tool()
def hello(name: str) -> str:
"""Pasveikinti asmenį.
Args:
name: Asmens vardas
Returns:
Pasveikinimo žinutė
"""
return f"Hello {name} from Hugging Face Spaces!"
@asynccontextmanager
async def lifespan(app: FastAPI):
async with mcp.session_manager.run():
yield
# „Space“ prieglobos vardas, formato <user>-<space>.hf.space
SPACE_HOST = os.environ.get("MCP_PUBLIC_HOST", "localhost")
security = TransportSecuritySettings(allowed_hosts=[SPACE_HOST, f"{SPACE_HOST}:*"])
api = FastAPI(lifespan=lifespan)
api.mount("/mcp-endpoint", mcp.streamable_http_app(transport_security=security))
# Jautriems kintamiesiems naudokite „HF Secrets“
API_KEY = os.environ.get("MY_API_KEY", "")
Platformos ypatybė slypi faile README, kurio YAML antraštė valdo „Space“ kūrimą. Laukas app_port turi atitikti prievadą, kurį tavo serveris iš tikrųjų klauso; priešingu atveju diegimas bus sėkmingas, bet serveris liks nepasiekiamas:
---
title: My MCP Server
emoji: 🔧
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
---
# Sukurkite „Space“ svetainėje huggingface.co
# Išsiųskite kodą
git push
# „Space“ diegiamas automatiškai
Tavo galutinis taškas tada tampa https://your-username-mon-mcp-space.hf.space/mcp-endpoint/mcp, teikiamas per HTTPS. Lieka vienas konfigūravimo žingsnis: deklaruok šį prieglobos vardą, your-username-mon-mcp-space.hf.space, kintamajame MCP_PUBLIC_HOST „Space“ nustatymuose. Be to, SDK atmes kiekvieną užklausą su klaida 421 Invalid Host header.
2 variantas: „Docker“
Kai tik serveris pradeda liesti vidinius duomenis, taisykle tampa hostinimas savo infrastruktūroje, o „Docker“ yra standartinis formatas. „Dockerfile“ reikia tik kelių instrukcijų, priklausomybių diegimą dedant prieš kopijuojant kodą, kad perstatant būtų panaudotas sluoksnių kaupimas:
FROM python:3.12-slim
WORKDIR /app
# Diegti priklausomybes
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
# Kopijuoti kodą
COPY . .
# Atverti prievadą
EXPOSE 8000
# Paleisti serverį
CMD ["uvicorn", "server:api", "--host", "0.0.0.0", "--port", "8000"]
fastapi>=0.115.0
uvicorn>=0.30.0
mcp>=2.2,<3
httpx>=0.27.0 # tik jei tavo įrankiai jį naudoja: SDK v2 jo nebenaudoja
Paleidimo metu būtent parinktis --restart unless-stopped atskiria gamybinį diegimą nuo paprasto testavimo: be jos pirmasis gedimas išjungia tavo serverį, kol kas nors tai pastebi.
# Sukurti atvaizdą
docker build -t mon-mcp-server .
# Paleisti konteinerį
docker run -d \
--name mcp-server \
-p 8000:8000 \
-e MY_API_KEY="secret" \
-e DATABASE_URL="postgresql://..." \
--restart unless-stopped \
mon-mcp-server
„Docker Compose“ daro šią konfigūraciją atkartojamą ir pridėja būklės tikrinimą (health check), kurį orchestratorius naudoja aptikti užšalusiam serveriui – gyvas procesas, kuris nebereaguoja, yra scenarijus, kurio paprastas automatinis paleidimas iš naujo neapima:
# docker-compose.yml
version: "3.8"
services:
mcp-server:
build: .
ports:
- "8000:8000"
environment:
- MY_API_KEY=${MY_API_KEY}
- DATABASE_URL=${DATABASE_URL}
restart: unless-stopped
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8000/"]
interval: 30s
retries: 3
3 ir 4 variantai: Valdomi diegimai
„Prefect Horizon“ (anksčiau „FastMCP Cloud“), platforma iš komandos, sukūrusios nepriklausomą „FastMCP“ sistemą, pašalina infrastruktūros žingsnį: prisijungi adresu horizon.prefect.io naudodamas savo „GitHub“ paskyrą, pasirenki saugyklą ir serverio failą, o platforma sukuria ir paskelbia URL su integruotu autentifikavimu. Ji skirta serveriams, parašytiems naudojant tą sistemą (pip install fastmcp, from fastmcp import FastMCP), kuri skiriasi nuo oficialaus SDK, naudojamo šiame kurse; asmeniniams projektams yra nemokamas lygmuo.
„Cloudflare Workers“ taikosi į kitą naudojimo profilį: be serverio (serverless), vykdymas arčiausiai naudotojo, taigi mažesnė delsos trukmė. Specialus šablonas padeda pradėti projektą:
# Naudoti „Cloudflare“ MCP šabloną
npm create cloudflare@latest -- remote-mcp-server-authless --template=cloudflare/ai/demos/remote-mcp-authless
Abu variantai sutaupo nuo sertifikatų valdymo ir paleidimo iš naujo, tačiau kaina yra priklausomybė nuo platformos ir vykdymo apribojimai – pavyzdžiui, be serverio veikiantis „Worker“ netinka būsenos turinčiam (stateful) serveriui.
Diegimo saugumas
HTTPS yra neprivalomas: „Vibe“ atmeta gryno teksto galutinius taškus, o per HTTP keliaujantis prieigos raktas yra pažeistas raktas. Yra trys keliai tai pasiekti, priklausomai nuo tavo hostingo. Atvirkštinis proxy (pvz., „Nginx“ arba „Caddy“), pastatytas prieš tavo serverį su „Let’s Encrypt“ sertifikatu, tinka dedikuoto serverio atveju. Debesims skirtos platformos – „Hugging Face“, „Cloudflare“ ir dauguma PaaS teikėjų – HTTPS suteikia automatiškai. Tunelis, pavyzdžiui, „Cloudflare Tunnel“, atveria serverį, liekantį tavo vidiniame tinkle, neatverdamas prievadų.
Jokia paslaptis neturi atsirasti kode. Atkreipk dėmesį į skirtumą tarp dviejų toliau pateiktų sintaksių: os.environ["MCP_API_TOKEN"] sukelia paleidimo gedimą, jei kintamojo nėra, kas yra pageidaujamas elgesys privalomai paslapčiai, tuo tarpu os.environ.get() toleruoja nebuvimą neprivalomoms reikšmėms.
import os
# Konfigūravimas per aplinkos kintamuosius
API_TOKEN = os.environ["MCP_API_TOKEN"] # Privaloma
DATABASE_URL = os.environ.get("DATABASE_URL") # Neprivaloma
DEBUG = os.environ.get("DEBUG", "false") == "true"
Viešas serveris be užklausų ribojimo (rate limiting) galiausiai bus perpildytas, tyčia ar netyčia. Daugeliu atvejų pakanka IP pagrįsto ribotuvo:
from fastapi import FastAPI, Request
from slowapi import Limiter, _rate_limit_exceeded_handler
limiter = Limiter(key_func=lambda request: request.client.host)
api = FastAPI()
api.state.limiter = limiter
@api.middleware("http")
async def rate_limit(request: Request, call_next):
# 100 užklausų per minutę vienam IP
...
Matyti, kas vyksta
Gamyboje nebeturi terminalo prieš akis, o įrankis, kuris nepavyksta vieną kartą iš dešimties, gali būti diagnozuotas tik naudojant pėdsakus (traces). Mažiausiai reikia fiksuoti kiekvieno kvietimo įvestį, išvestį ir trukmę:
import logging
import time
logger = logging.getLogger("mcp-server")
@mcp.tool()
async def my_tool(param: str) -> str:
"""Mano įrankis su žurnalavimu."""
start = time.time()
logger.info(f"Tool called with param={param}")
try:
result = await process(param)
duration = time.time() - start
logger.info(f"Tool finished in {duration:.2f}s")
return result
except Exception as e:
logger.error(f"Error in tool: {e}")
raise
Trukmės matavimas nėra prabanga: įrankis, kuris atsako per dvylika sekundžių, sukelia kliento pusės laiko limito viršijimą ir sudaro įspūdį, kad serveris sugedęs, nors jis iš tikrųjų veikia. Prieš paskelbdamas savo serverį, peržiūrėk šiuos šešis konfigūravimo punktus.
- HTTPS aktyvus ir galiojantis sertifikatas
- Aplinkos kintamieji visoms paslaptims
- Įjungtas struktūruotas žurnalavimas
- Būklės tikrinimo galutinis taškas (
/arba/health) - Automatinis paleidimas iš naujo įvykus gedimui
- Sukonfigūruotas užklausų ribojimas
Lieka du patikrinimai, kuriuos žmonės dažniausiai praleidžia, tačiau kurie atskleidžia tikras problemas: testas su „MCP Inspector“, paleistu iš išorės, ir testas iš „Mistral Vibe“. Serveris, kuris puikiai atsako iš tavo kompiuterio, gali būti užblokuotas ugniasienės arba CORS konfigūracijos, kai tik jis yra kviečiamas iš kitur.
Svarbiausi punktai
- „Hugging Face Spaces“: greičiausias, nemokamas, idealus pradžiai
- „Docker“: visiška kontrolė, tinkamas dedikuotiems serveriams ir debesijai
- „Prefect Horizon“ (buvęs „FastMCP Cloud“): diegimas iš „GitHub“, skirtas serveriams, parašytiems naudojant „FastMCP“ sistemą
- „Cloudflare Workers“: be serverio (serverless), maža delsos trukmė, mastelio keitimas
- Apsaugok naudojant HTTPS, aplinkos kintamuosius ir užklausų ribojimą
- Gamybiniam derinimui pridėk stebėseną ir žurnalus