Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Ανάπτυξη διακομιστή MCP σε περιβάλλον παραγωγής

Μάθημα 12 / 14 Ενημερώθηκε 2 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Από το πρωτότυπο στον διακομιστή παραγωγής
  2. Επιλογή 1: Hugging Face Spaces
  3. Επιλογή 2: Docker
  4. Επιλογές 3 και 4: Διαχειριζόμενες αναπτύξεις
  5. Ασφάλιση της ανάπτυξης
  6. Παρακολούθηση του τι συμβαίνει
  7. Βασικά σημεία

Ενημέρωση 2 Νοεμβρίου 2026 — Το Le Chat είναι πλέον Vibe. Από τις 28 Μαΐου 2026, το Le Chat μετονομάστηκε σε Vibe (παραμένει στο chat.mistral.ai): ένας ενιαίος πράκτορας για εργασία και κώδικα, ο οποίος διατηρεί τις συνομιλίες, τις ρυθμίσεις και τις συνδρομές σας. Η παλιά εμπειρία του Le Chat παραμένει προσβάσιμη στη λειτουργία Chat· στη λειτουργία Work, οι πράκτορες είναι πλέον δεξιότητες (καλούνται με @), οι μνήμες αποτελούν τη βάση γνώσεων και η βαθιά έρευνα είναι η δεξιότητα Deep Research. Τα πακέτα ονομάζονται πλέον Mistral Free, Pro, Team και Enterprise. Αυτό το μάθημα χρησιμοποιεί την ονομασία Vibe· ορισμένα μενού που περιγράφονται εδώ ενδέχεται να έχουν αλλάξει ονομασία ή θέση.

Ενημέρωση 2 Νοεμβρίου 2026 — MCP Python SDK v2. Αυτό το μάθημα ακολουθεί πλέον την έκδοση 2 του SDK mcp (2.3.0 στις 2 Οκτωβρίου 2026): το MCPServer αντικαθιστά το FastMCP, οι ρυθμίσεις μεταφοράς μεταφέρονται στο run() ή στο streamable_http_app(), και μια εφαρμογή που εκτίθεται υπό πραγματικό όνομα κεντρικού υπολογιστή πρέπει να δηλώνει αυτό το όνομα (transport_security). Αυτή είναι επίσης η έκδοση που απαιτείται από το Mistral SDK: το πρόσθετο mistralai[agents] απαιτεί mcp>=2.2.0,<3.0. Πηγές: Τι νέο υπάρχει στο v2 · Οδηγός μετάβασης · Ανάπτυξη και κλιμάκωση.

Από το πρωτότυπο στον διακομιστή παραγωγής

Ο διακομιστής σας εκτελείται τοπικά και το ngrok τον εκθέτει στον κόσμο μόνο για επίδειξη. Το πρόβλημα ξεκινά όταν κάποιος άλλος χρειάζεται να τον χρησιμοποιήσει: κλείνετε το τερματικό σας, η URL παύει να λειτουργεί και κάθε σύνδεση που διαμόρφωσαν οι συνάδελφοί σας διακόπτεται. Η μετάβαση σε παραγωγή σημαίνει ουσιαστικά την απόκτηση μιας σταθερής διεύθυνσης, διαθέσιμης 24/7, που εξυπηρετείται μέσω HTTPS. Τέσσερις επιλογές σας οδηγούν εκεί, από την ταχύτερη έως την πιο ελεγχόμενη. Η επιλογή σας εξαρτάται κυρίως από το πόσο ευαίσθητα είναι τα δεδομένα σας και πόσο έλεγχο θέλετε πάνω στην υποδομή.

Επιλογή 1: Hugging Face Spaces

Τα Hugging Face Spaces παρέχουν δωρεάν εικονικές μηχανές χωρίς GPU, οι οποίες είναι περισσότερο από αρκετές για έναν διακομιστή MCP που αναμεταδίδει κλήσεις API. Αυτός είναι ο ταχύτερος δρόμος για μια πραγματική ανάπτυξη: τρία αρχεία και ένα git push.

mon-mcp-space/
├── app.py              # FastAPI + διακομιστής MCP
├── requirements.txt    # Εξαρτήσεις
└── README.md           # Μεταδεδομένα Space

Το αρχείο app.py ακολουθεί την ακριβή δομή που έχετε δει μέχρι τώρα, με τη διαφορά ότι οι ευαίσθητες τιμές διαβάζονται από το περιβάλλον—τα HF Secrets τις injectάρουν εκεί:

# app.py
"""Διακομιστής MCP αναπτυγμένος σε 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:
    """Χαιρετισμός ενός ατόμου.

    Args:
        name: Το μικρό όνομα του ατόμου

    Returns:
        Μήνυμα χαιρετισμού
    """
    return f"Hello {name} from Hugging Face Spaces!"

@asynccontextmanager
async def lifespan(app: FastAPI):
    async with mcp.session_manager.run():
        yield

# Όνομα κεντρικού υπολογιστή Space, στη μορφή <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))

# Για ευαίσθητες μεταβλητές, χρησιμοποιήστε τα HF Secrets
API_KEY = os.environ.get("MY_API_KEY", "")

Η ιδιαιτερότητα της πλατφόρμας βρίσκεται στο README, του οποίου η κεφαλίδα YAML καθοδηγεί τη δημιουργία του Space. Το πεδίο app_port πρέπει να ταιριάζει με τη θύρα στην οποία ακούει πραγματικά ο διακομιστής σας· διαφορετικά, η ανάπτυξη succeeds αλλά παραμένει απρόσιτη:

---
title: My MCP Server
emoji: 🔧
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
---
# Δημιουργήστε ένα Space στο huggingface.co
# Σπρώξτε τον κώδικα
git push
# Το Space αναπτύσσεται αυτόματα

Το endpoint σας γίνεται τότε https://your-username-mon-mcp-space.hf.space/mcp-endpoint/mcp, εξυπηρετούμενο μέσω HTTPS. Απομένει ένα βήμα διαμόρφωσης: δηλώστε αυτό το όνομα κεντρικού υπολογιστή, your-username-mon-mcp-space.hf.space, στη μεταβλητή MCP_PUBLIC_HOST στις ρυθμίσεις του Space. Χωρίς αυτό, το SDK απορρίπτει κάθε αίτημα με σφάλμα 421 Invalid Host header.

Επιλογή 2: Docker

Μόλις ο διακομιστής αγγίξει εσωτερικά δεδομένα, η φιλοξενία στην δική σας υποδομή γίνεται κανόνας, και το Docker είναι το πρότυπο format. Το Dockerfile χρειάζεται μόνο λίγες εντολές, με την εγκατάσταση των εξαρτήσεων να τοποθετείται πριν την αντιγραφή του κώδικα για να εκμεταλλευτείτε την αποθήκευση σε στρώματα (layer caching) κατά τις επαναδημιουργίες:

FROM python:3.12-slim

WORKDIR /app

# Εγκατάσταση εξαρτήσεων
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# Αντιγραφή κώδικα
COPY . .

# Έκθεση θύρας
EXPOSE 8000

# Εκκίνηση διακομιστή
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   # μόνο αν τα εργαλεία σας το χρησιμοποιούν: το SDK v2 δεν το εγκαθιστά πλέον

Κατά την εκκίνηση, η επιλογή --restart unless-stopped είναι αυτή που διαχωρίζει μια ανάπτυξη παραγωγής από μια απλή δοκιμή: χωρίς αυτήν, η πρώτη κατάρρευση βγάζει εκτός λειτουργίας τον διακομιστή σας μέχρι να το προσέξει κάποιος.

# Δημιουργία της εικόνας
docker build -t mon-mcp-server .

# Εκτέλεση του container
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 κάνει αυτή τη διαμόρφωση αναπαραγώγιμη και προσθέτει έναν έλεγχο υγείας (health check), τον οποίο χρησιμοποιεί ο orchestrator για να ανιχνεύσει έναν παγωμένο διακομιστή—μια ζωντανή διαδικασία που δεν ανταποκρίνεται πλέον είναι ένα σενάριο που οι απλές αυτόματες επανεκκινήσεις δεν καλύπτουν:

# 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 και 4: Διαχειριζόμενες αναπτύξεις

Το Prefect Horizon (πρώην FastMCP Cloud), η πλατφόρμα από την ομάδα πίσω από το ανεξάρτητο framework FastMCP, αφαιρεί το βήμα της υποδομής: συνδέεστε στο horizon.prefect.io με τον λογαριασμό GitHub σας, επιλέγετε το αποθετήριο και το αρχείο διακομιστή, και η πλατφόρμα δημιουργεί και δημοσιεύει μια URL με ενσωματωμένο έλεγχο ταυτότητας. Στόχος είναι διακομιστές γραμμένοι με αυτό το framework (pip install fastmcp, from fastmcp import FastMCP), το οποίο διαφέρει από το επίσημο SDK που χρησιμοποιείται σε αυτό το μάθημα· υπάρχει ένα δωρεάν επίπεδο για προσωπικά έργα.

Το Cloudflare Workers στοχεύει σε ένα διαφορετικό προφίλ χρήσης: serverless, με εκτέλεση όσο το δυνατόν πιο κοντά στον χρήστη και συνεπώς μειωμένη καθυστέρηση. Ένα ειδικό πρότυπο εκκινεί το έργο:

# Χρησιμοποιήστε το πρότυπο MCP του Cloudflare
npm create cloudflare@latest -- remote-mcp-server-authless --template=cloudflare/ai/demos/remote-mcp-authless

Και οι δύο επιλογές σας γλιτώνουν από τη διαχείριση πιστοποιητικών και επανεκκινήσεων, με αντάλλαγμα την εξάρτηση από την πλατφόρμα και τους περιορισμούς εκτέλεσης—για παράδειγμα, ένας serverless Worker δεν ταιριάζει καλά με έναν διακομιστή με κατάσταση (stateful).

Ασφάλιση της ανάπτυξης

Το HTTPS είναι αδιαπραγμάτευτο: το Vibe απορρίπτει endpoints σε απλό κείμενο, και ένα token που ταξιδεύει μέσω HTTP είναι ένα compromised token. Τρεις δρόμοι οδηγούν εκεί ανάλογα με τη φιλοξενία σας. Ένας αντίστροφος διακομιστής μεσολάβησης (reverse proxy) όπως ο Nginx ή ο Caddy τοποθετημένος μπροστά από τον διακομιστή σας, με πιστοποιητικό Let’s Encrypt, καλύπτει την περίπτωση του αφιερωμένου διακομιστή. Οι πλατφόρμες cloud-native—Hugging Face, Cloudflare και οι περισσότεροι πάροχοι PaaS—παρέχουν HTTPS αυτόματα. Μια σήραγγα (tunnel), όπως το Cloudflare Tunnel, εκθέτει έναν διακομιστή που παραμένει στο εσωτερικό σας δίκτυο χωρίς να ανοίγει θύρες.

Κανένα μυστικό δεν πρέπει να εμφανίζεται στον κώδικα. Σημειώστε τη διάκριση μεταξύ των δύο συντάξεων παρακάτω: το os.environ["MCP_API_TOKEN"] προκαλεί αποτυχία εκκίνησης αν λείπει η μεταβλητή, κάτι που είναι ακριβώς η επιθυμητή συμπεριφορά για ένα υποχρεωτικό μυστικό, ενώ το os.environ.get() ανέχεται την απουσία για προαιρετικές τιμές.

import os

# Διαμόρφωση μέσω μεταβλητών περιβάλλοντος
API_TOKEN = os.environ["MCP_API_TOKEN"]       # Υποχρεωτικό
DATABASE_URL = os.environ.get("DATABASE_URL")  # Προαιρετικό
DEBUG = os.environ.get("DEBUG", "false") == "true"

Ένας δημόσιος διακομιστής χωρίς όριο ρυθμού (rate limiting) τελικά κορέννεται, εκούσια ή ακούσια. Ένας περιοριστής βάσει IP αρκεί στις περισσότερες περιπτώσεις:

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 αιτήματα ανά λεπτό ανά IP
    ...

Παρακολούθηση του τι συμβαίνει

Στην παραγωγή, δεν έχετε πλέον το τερματικό σας μπροστά σας, και ένα εργαλείο που αποτυγχάνει μία στις δέκα φορές μπορεί να διαγνωστεί μόνο με ίχνη (traces). Τουλάχιστον, instrumentαρετε την είσοδο, την έξοδο και τη διάρκεια κάθε κλήσης:

import logging
import time

logger = logging.getLogger("mcp-server")

@mcp.tool()
async def my_tool(param: str) -> str:
    """Το εργαλείο μου με καταγραφή."""
    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

Η μέτρηση της διάρκειας δεν είναι πολυτέλεια: ένα εργαλείο που χρειάζεται δώδεκα δευτερόλεπτα για να απαντήσει προκαλεί timeouts στην πλευρά του πελάτη και δημιουργεί την εντύπωση ενός χαλασμένου διακομιστή όταν στην πραγματικότητα λειτουργεί. Πριν ανακοινώσετε τον διακομιστή σας, αναθεωρήστε τα ακόλουθα έξι σημεία διαμόρφωσης.

  • Ενεργό HTTPS και έγκυρο πιστοποιητικό
  • Μεταβλητές περιβάλλοντος για όλα τα μυστικά
  • Ενεργοποιημένη δομημένη καταγραφή (structured logging)
  • Endpoint ελέγχου υγείας (/ ή /health)
  • Αυτόματη επανεκκίνηση σε περίπτωση κατάρρευσης
  • Διαμορφωμένο όριο ρυθμού (rate limiting)

Απομένουν δύο έλεγχοι, αυτοί που οι άνθρωποι παραλείπουν συχνότερα αλλά που αποκαλύπτουν τα πραγματικά προβλήματα: μια δοκιμή με το MCP Inspector εκκινούμενο από έξω, και στη συνέχεια μια δοκιμή από το Mistral Vibe. Ένας διακομιστής που ανταποκρίνεται τέλεια από το μηχάνημά σας μπορεί να αποκλειστεί από ένα τείχος προστασίας ή μια διαμόρφωση CORS μόλις κληθεί από αλλού.

Βασικά σημεία

  • Hugging Face Spaces: ταχύτερο, δωρεάν, ιδανικό για ξεκίνημα
  • Docker: πλήρης έλεγχος, κατάλληλο για αφιερωμένους διακομιστές και cloud
  • Prefect Horizon (πρώην FastMCP Cloud): ανάπτυξη από GitHub, για διακομιστές γραμμένους με το framework FastMCP
  • Cloudflare Workers: serverless, χαμηλή καθυστέρηση, κλιμακώσιμο
  • Ασφάλιση με HTTPS, μεταβλητές περιβάλλοντος και όριο ρυθμού
  • Προσθήκη παρακολούθησης και καταγραφών για αποσφαλμάτωση σε παραγωγή