Iddispjega Server MCP għall-Produzzjoni
F'din il-paġna
Aġġornament 2 ta’ Novembru, 2026 — Le Chat issa huwa Vibe. Mill-28 ta’ Mejju, 2026, Le Chat ġie mibdul għal Vibe (għadu f’chat.mistral.ai): aġent wieħed għax-xogħol u l-kodiċi, li jżomm il-konversazzjonijiet, l-issettjar u s-sottoskrizzjonijiet tiegħek. L-esperjenza antika ta’ Le Chat tibqa’ aċċessibbli fil-modalità Chat; fil-modalità Work, l-aġenti issa huma ħiliet (invokati b’
@), il-memorji jiffurmaw il-bażi tal-għarfien, u r-riċerka fil-fond hija l-ħila Deep Research. Il-pjanijiet issa jissejħu Mistral Free, Pro, Team, u Enterprise. Din il-lezzjoni tuża l-isem Vibe; xi menijiet deskritti hawnhekk jista’ jkun li nbidlu isimhom jew posthom.
Aġġornament 2 ta’ Novembru, 2026 — MCP Python SDK v2. Dan il-kors issa jsegwi l-verżjoni 2 tal-SDK
mcp(2.3.0 sal-2 ta’ Ottubru, 2026):MCPServertissostitwixxiFastMCP, l-issettjar tat-trasport jimxi għalrun()jewstreamable_http_app(), u app esposta taħt isem ta’ host reali trid tiddikjara dak l-isem ta’ host (transport_security). Din hija wkoll il-verżjoni meħtieġa mill-Mistral SDK: l-extramistralai[agents]jeħtieġmcp>=2.2.0,<3.0. Sorsi: X’hemm ġdid f’v2 · Gwida għall-Migrazzjoni · Iddispjega u skala.
Mill-prototip għas-server tal-produzzjoni
Is-server tiegħek jaħdem lokalment, u ngrok jesponih lid-dinja biss għal dimostrazzjoni. Il-problema tibda meta persuna oħra tkollha bżonn tużah: inti tagħlaq it-terminal tiegħek, l-URL imut, u kull konnettur li l-kollegi tiegħek ikkonfiguraw jinkiser. Il-moviment lejn il-produzzjoni essenzjalment ifisser li tikseb indirizz stabbli, disponibbli 24/7, servut fuq HTTPS. Erba’ għażliet iwassluk hemm, mill-aktar mgħaġġla għall-aktar ikkontrollata. L-għażla tiegħek tiddependi l-aktar fuq kemm huma sensittivi d-dejta tiegħek u kemm trid kontroll fuq l-infrastruttura.
Għażla 1: Hugging Face Spaces
Hugging Face Spaces jipprovdi magni virtwali b’xejn mingħajr GPUs, li huma aktar minn biżżejjed għal server MCP li jgħaddi sejħiet API. Din hija l-aktar triq mgħaġġla lejn iddispjega reali: tliet fajls u git push.
mon-mcp-space/
├── app.py # FastAPI + server MCP
├── requirements.txt # Dipendenzi
└── README.md # Metadejta tal-Ispazju
Il-fajl app.py isegwi l-istruttura eżatta li rajt sa issa, ħlief li valuri sensittivi jinqraw mill-ambjent—HF Secrets jinjettahom hemmhekk:
# app.py
"""Server MCP iddispjatat fuq 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:
"""Sellem lil persuna.
Args:
name: L-isem tal-persuna
Returns:
Messaġġ ta' tislima
"""
return f"Hello {name} minn Hugging Face Spaces!"
@asynccontextmanager
async def lifespan(app: FastAPI):
async with mcp.session_manager.run():
yield
# Isem tal-host tal-Ispazju, fil-forma <utent>-<ispazju>.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))
# Għal varjabbli sensittivi, uża HF Secrets
API_KEY = os.environ.get("MY_API_KEY", "")
L-iżball tal-pjattaforma jinsab fir-README, li l-intestazzjoni YAML tiegħu tmexxi l-bini tal-Ispazju. Il-qasam app_port irid jaqbel mal-port li s-server tiegħek effettivament jisma’ fuqu; inkella, id-dispjega jirnexxi iżda jibqa’ inaċċessibbli:
---
title: My MCP Server
emoji: 🔧
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
---
# Oħloq Spazju fuq huggingface.co
# Ippushja l-kodiċi
git push
# L-Ispazju jiddispjega awtomatikament
L-endpoint tiegħek imbagħad isir https://your-username-mon-mcp-space.hf.space/mcp-endpoint/mcp, servut fuq HTTPS. Tibqa’ pass wieħed ta’ konfigurazzjoni: iddikjara dan l-isem tal-host, your-username-mon-mcp-space.hf.space, fil-varjabbli MCP_PUBLIC_HOST fl-issettjar tal-Ispazju. Mingħajru, l-SDK jiċħad kull talba bi żball 421 Invalid Host header.
Għażla 2: Docker
Hekk kif is-server jmiss dejta interna, l-hosting fuq l-infrastruttura tiegħek stess isir ir-regola, u Docker huwa l-format standard. Il-Dockerfile jieħu ftit struzzjonijiet biss, bl-installazzjoni tad-dipendenzi mqiegħda qabel ma tikkopja l-kodiċi biex tisfrutta l-cache tal-livelli waqt ir-ribini:
FROM python:3.12-slim
WORKDIR /app
# Installa d-dipendenzi
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
# Ikkopja l-kodiċi
COPY . .
# Esponi l-port
EXPOSE 8000
# Ibda s-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 # biss jekk l-għodod tiegħek jużawh: SDK v2 ma jinstallahx aktar
Fil-bidu, l-għażla --restart unless-stopped hija dak li jiddistingwi dispjega tal-produzzjoni minn test sempliċi: mingħajrha, l-ewwel ħsara tieħu s-server tiegħek offline sakemm xi ħadd jinnota.
# Ibni l-immaġni
docker build -t mon-mcp-server .
# Ħaddem il-kontenitur
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 jagħmel din il-konfigurazzjoni riproduċibbli u jżid kontroll tas-saħħa (health check), li l-orchestratur juża biex jiskopri server iffriżat—proċess ħaj li ma jirrispondix huwa xenarju li r-avvjar awtomatiku sempliċi ma jkoprix:
# 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
Għażliet 3 u 4: Dispjegi mmaniġġjati
Prefect Horizon (qabel FastMCP Cloud), il-pjattaforma mit-tim wara l-qafas indipendenti FastMCP, ineħħi l-pass tal-infrastruttura: tidħol f’horizon.prefect.io bil-kont GitHub tiegħek, tagħżel ir-repożitorju u l-fajl tas-server, u l-pjattaforma tibni u tippubblika URL b’awtentikazzjoni integrata. Timmira lejn servers miktuba b’dak il-qafas (pip install fastmcp, from fastmcp import FastMCP), li huwa distint mill-SDK uffiċjali użat f’dan il-kors; jeżisti livell b’xejn għal proġetti personali.
Cloudflare Workers timmira lejn profil ta’ użu differenti: serverless, b’eżekuzzjoni l-aktar qrib l-utent u għalhekk latenza mnaqqsa. Mudell dedikat ibeda l-proġett:
# Uża l-mudell MCP ta' Cloudflare
npm create cloudflare@latest -- remote-mcp-server-authless --template=cloudflare/ai/demos/remote-mcp-authless
Iż-żewġ għażliet iffrankawlek milli timmaniġġja ċertifikati u avvjar mill-ġdid, bl-ispiża tad-dipendenza mill-pjattaforma u restrizzjonijiet ta’ eżekuzzjoni—Worker serverless, pereżempju, ma jgħaqqadx tajjeb ma’ server bi stat (stateful).
Issikkar tad-dispjega
HTTPS mhux negozjabbli: Vibe jirrifjuta endpoints f’test ċar, u token li jivvjaġġa fuq HTTP huwa token kompromess. Tliet toroq iwasslu hemmhekk skont l-hosting tiegħek. Reverse proxy bħal Nginx jew Caddy mqiegħed quddiem is-server tiegħek, b’ċertifikat Let’s Encrypt, ikopri l-każ tas-server dedikat. Pjattaformi native tal-cloud—Hugging Face, Cloudflare, u l-biċċa l-kbira tal-fornituri PaaS—jipprovdu HTTPS awtomatikament. Tunnel, bħal Cloudflare Tunnel, jesponi server li jibqa’ fuq in-netwerk intern tiegħek mingħajr ma jiftaħ ports.
L-ebda sigriet m’għandu jidher fil-kodiċi. Innota d-distinzjoni bejn iż-żewġ sintassi hawn taħt: os.environ["MCP_API_TOKEN"] jikkawża li l-bidu jfalli jekk il-varjabbli nieqsa, li huwa eżattament l-imġiba mixtieqa għal sigriet obbligatorju, filwaqt li os.environ.get() jittollera n-nuqqas għal valuri fakultattivi.
import os
# Konfigurazzjoni permezz ta' varjabbli tal-ambjent
API_TOKEN = os.environ["MCP_API_TOKEN"] # Obbligatorju
DATABASE_URL = os.environ.get("DATABASE_URL") # Fakultattiv
DEBUG = os.environ.get("DEBUG", "false") == "true"
Server pubbliku mingħajr limitazzjoni tar-rata (rate limiting) eventwalment jitlef is-sens, volontarjament jew le. Limitatur ibbażat fuq l-IP huwa biżżejjed fil-biċċa l-kbira tal-każijiet:
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 talba kull minuta kull IP
...
Naraw x’qed jiġri
Fil-produzzjoni, m’għadekx għandek it-terminal tiegħek quddiemek, u għodda li tfalli darba minn għaxra tista’ tiġi djanjostikata biss bit-traċċi. Mill-inqas, strumentalizza l-input, l-output, u t-tul ta’ kull sejħa:
import logging
import time
logger = logging.getLogger("mcp-server")
@mcp.tool()
async def my_tool(param: str) -> str:
"""L-għodda tiegħi bil-logging."""
start = time.time()
logger.info(f"Għodda msejħa b'param={param}")
try:
result = await process(param)
duration = time.time() - start
logger.info(f"L-għodda lestiet f'{duration:.2f}s")
return result
except Exception as e:
logger.error(f"Żball fl-għodda: {e}")
raise
Il-kejl tat-tul mhuwiex lussu: għodda li tieħu tnax-il sekonda biex tirrispondi tikkawża timeouts fuq in-naħa tal-klijent u tagħti l-impressjoni ta’ server miksur meta fil-fatt qed taħdem. Qabel ma tħabbar is-server tiegħek, irrevedi s-sitt punti ta’ konfigurazzjoni li ġejjin.
- HTTPS attiv u ċertifikat validu
- Varjabbli tal-ambjent għas-sigrieti kollha
- Logging strutturat attivat
- Endpoint tal-kontroll tas-saħħa (
/jew/health) - Avvjar awtomatiku fuq ħsara
- Limitazzjoni tar-rata kkonfigurata
Jibqgħu żewġ verifiki, dawk li n-nies l-aktar spiss jaqbżu iżda li jiżvelaw il-problemi reali: test b’MCP Inspector imnedija minn barra, imbagħad test minn Mistral Vibe. Server li jirrispondi perfettament mill-magna tiegħek jista’ jiġi mblukkat minn firewall jew konfigurazzjoni CORS hekk kif jiġi msejjaħ minn xi mkien ieħor.
Punti Ewlenin
- Hugging Face Spaces: l-aktar mgħaġġel, b’xejn, ideali biex tibda
- Docker: kontroll totali, adattat għal servers dedikati u cloud
- Prefect Horizon (ex-FastMCP Cloud): dispjega minn GitHub, għal servers miktuba bil-qafas FastMCP
- Cloudflare Workers: serverless, latenza baxxa, skalabbli
- Issikkar b’HTTPS, varjabbli tal-ambjent, u limitazzjoni tar-rata
- Żid monitoraġġ u logs għad-dibugging tal-produzzjoni