Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Iddispjega Server MCP għall-Produzzjoni

Lezzjoni 12 / 14 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Mill-prototip għas-server tal-produzzjoni
  2. Għażla 1: Hugging Face Spaces
  3. Għażla 2: Docker
  4. Għażliet 3 u 4: Dispjegi mmaniġġjati
  5. Issikkar tad-dispjega
  6. Naraw x’qed jiġri
  7. Punti Ewlenin

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): MCPServer tissostitwixxi FastMCP, l-issettjar tat-trasport jimxi għal run() jew streamable_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-extra mistralai[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