Δημιουργήστε και αναπτύξτε τον δικό σας διακομιστή MCP
Σε αυτήν τη σελίδα
Ενημέρωση 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· λάβετε υπόψη ότι ορισμένα μενού που περιγράφονται εδώ ενδέχεται να έχουν αλλάξει ονομασία ή θέση.
Από την Ιδέα στον Διακομιστή Παραγωγής
Γνωρίζετε πώς να χρησιμοποιείτε υπάρχοντες συνδέσμους και να προσθέτετε προσαρμοσμένους. Τώρα ήρθε η ώρα για το τελικό βήμα: να γράψετε τον δικό σας διακομιστή MCP και να τον αναπτύξετε για χρήση στο Vibe. Θα καλύψουμε εδώ ολόκληρη τη διαδρομή, από το πρώτο αρχείο Python στον υπολογιστή σας έως τη φιλοξενία σε περιβάλλον παραγωγής, εξετάζοντας τις επιλογές σχεδιασμού που χωρίζουν έναν λειτουργικό διακομιστή από έναν που το μοντέλο δεν καλεί ποτέ σωστά.
Δημιουργία Διακομιστή MCP Τοπικά
Η βιβλιοθήκη FastMCP (pip install fastmcp, έκδοση 4 από τον Νοέμβριο του 2026), ένα πλαίσιο εργασίας ανεξάρτητο από το επίσημο SDK mcp, ανάγει τη δημιουργία διακομιστή σε λίγους διακοσμητές:
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."
Όλα κρίνονται σε αυτές τις λίγες γραμμές. Ο διακοσμητής @mcp.tool() καταχωρίζει τη συνάρτηση ως εργαλείο MCP. Το docstring γίνεται η περιγραφή που βλέπει το μοντέλο όταν αποφασίζει αν θα καλέσει το εργαλείο—επομένως, δεν είναι σχόλιο για τους συναδέλφους σας, αλλά λειτουργικό στοιχείο. Οι τύποι παραμέτρων (name: str) και οι τύποι επιστροφής (-> str) ενημερώνουν το μοντέλο για τους αναμενόμενους τύπους, ενώ το όνομα της συνάρτησης πρέπει να είναι σαφές και περιγραφικό. Η επίσημη εναλλακτική είναι το MCP SDK της Anthropic, διαθέσιμο σε Python και TypeScript: προσφέρει περισσότερο έλεγχο με τίμημα μια ελαφρώς πιο βαριά διαμόρφωση.
Επειδή το μοντέλο βλέπει μόνο την κειμενική περιγραφή του εργαλείου σας, γράψτε την σαν πλήρες εγχειρίδιο χρήστη:
@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.
"""
Παρατηρήστε τι προσθέτει αυτό το docstring σε σχέση με το προηγούμενο: την προϋπόθεση χρήσης, τις πιθανές τιμές για το category και τα όρια για το max_results. Δύο ακόμη κανόνες ολοκληρώνουν την άσκηση. Τα ονόματα πρέπει να είναι ρητά—προτιμήστε το search_products αντί του search, το create_invoice αντί του create, το get_user_orders αντί του get_data. Και οι επιστροφές πρέπει να είναι ευανάγνωστες: στείλτε πίσω κατανοητό κείμενο αντί για ακατέργαστα IDs, διαφορετικά το μοντέλο δεν θα μπορέσει να τα χρησιμοποιήσει για να διατυπώσει μια φυσική απάντηση.
Τοπικός Έλεγχος
Αρχικά, εκκινήστε τον διακομιστή, ο οποίος τρέχει σε μια τοπική θύρα, με προεπιλογή το localhost:8000:
python server.py
Στη συνέχεια, εκθέστε τον ώστε να μπορεί να τον προσεγγίσει το Vibe:
ngrok http 8000
Το ngrok παρέχει μια δημόσια διεύθυνση URL, για παράδειγμα https://abc123.ngrok.io, την οποία θα χρησιμοποιήσετε ως URL συνδέσμου στο Vibe—θυμηθείτε να προσθέσετε το /mcp στο τέλος για να λάβετε το πλήρες endpoint. Πριν προχωρήσετε στο Vibe, επικυρώστε τον διακομιστή με το MCP Inspector:
npx @modelcontextprotocol/inspector
Συνδεθείτε στον τοπικό σας διακομιστή, απαριθμήστε τα εργαλεία, δοκιμάστε τα μεμονωμένα και ελέγξτε τις επιστροφές. Αυτό σας λέει εάν τυχόν προβλήματα πηγάζουν από τον κώδικά σας ή από τον τρόπο με τον οποίο το μοντέλο ερμηνεύει τις περιγραφές σας.
Επιλογές Ανάπτυξης
Μόλις ο διακομιστής σας είναι έτοιμος, η φιλοξενία εξαρτάται κυρίως από τους περιορισμούς σας. Το Hugging Face Spaces είναι η δωρεάν επιλογή που προτείνει η ομάδα της Mistral AI: πρόκειται για εικονικές μηχανές που φιλοξενούν web εφαρμογές, εντελώς δωρεάν εφόσον δεν χρειάζεστε GPU. Μπορείτε να στήσετε τον διακομιστή MCP εκεί με το FastAPI και να αναπτύξετε πολλαπλούς διακομιστές στο ίδιο Space, ο καθένας με το δικό του endpoint—/api1/mcp, /api2/mcp—τα οποία το Vibe θα προσθέσει ως ξεχωριστούς συνδέσμους. Ένα επιπλέον πλεονέκτημα: τίποτα δεν σας εμποδίζει να προσθέσετε ένα frontend στο Space για να οπτικοποιήσετε τη δραστηριότητα του διακομιστή σας.
Το Prefect Horizon (πρώην FastMCP Cloud), η πλατφόρμα της ομάδας του FastMCP, εισάγει απευθείας ένα αποθετήριο GitHub που περιέχει έναν διακομιστή FastMCP: επιλέγετε το αποθετήριο στο horizon.prefect.io, η πλατφόρμα το δημιουργεί και δημοσιεύει μια πιστοποιημένη διεύθυνση URL· υπάρχει ένα δωρεάν επίπεδο για προσωπικά έργα. Για ελαφριούς διακομιστές χωρίς βαριές εξαρτήσεις, το Cloudflare Workers προσφέρει γρήγορη ανάπτυξη edge χαμηλού κόστους. Τέλος, οι παραδοσιακοί πάροχοι παραμένουν απολύτως βιώσιμοι για ομάδες που είναι ήδη εξοπλισμένες: AWS (Lambda, ECS), Google Cloud (Cloud Run, Cloud Functions) ή Azure (Functions, Container Apps).
Διακομιστές Πολλαπλών Εργαλείων έναντι Ενιαίου Εργαλείου
Μια κοινή αντανακλαστική κίνηση είναι να διαχωρίζετε τα εργαλεία πολύ λεπτομερώς. Η εμπειρία δείχνει το αντίθετο: ένα hackathon MCP που διοργάνωσε η Mistral έδειξε ότι οι ομάδες με τις καλύτερες επιδόσεις σχεδίασαν εργαλεία υψηλού επιπέδου που αντιστοιχούσαν σε πλήρεις ροές εργασίας. Εξέθεσαν το book_restaurant αντί για list_restaurants + check_availability + make_reservation, ή το deploy_application αντί για build + test + push + deploy. Το μοντέλο έχει λιγότερες πιθανότητες να μπερδέψει τη σειρά και ο σωρευτικός χρόνος απόκρισης μειώνεται ανάλογα.
Η κοκκοποίηση έχει νόημα σε τρεις περιπτώσεις: όταν δημιουργείτε έναν γενικό διακομιστή MCP που χρησιμοποιείται από διαφορετικές ομάδες, όταν τα βήματα μιας ροής εργασίας μπορούν να εξυπηρετήσουν ανεξάρτητα το ένα το άλλο, και όταν χρειάζεστε ευελιξία στη σειρά των λειτουργιών.
Διαχείριση Μεταβλητών Περιβάλλοντος
Οι διακομιστές σας θα χρειάζονται συχνά κλειδιά API, διαπιστευτήρια βάσεων δεδομένων ή άλλα μυστικά. Αποθηκεύστε τα συστηματικά σε μεταβλητές περιβάλλοντος, ποτέ μέσα στον κώδικα. Λάβετε ιδιαίτερα υπόψη ότι ένας δημόσιος διακομιστής MCP χωρίς πιστοποίηση επιτρέπει σε οποιονδήποτε να καταναλώσει τα κλειδιά API σας: προστατέψτε τον με ένα token ή OAuth μόλις καλεί μια επί πληρωμή υπηρεσία. Στα Hugging Face Spaces, τα Secrets του Space έχουν σχεδιαστεί ακριβώς για αυτόν τον σκοπό.
Βασικά σημεία
- Το FastMCP είναι ο απλούστερος τρόπος δημιουργίας διακομιστή MCP σε Python
- Βελτιώστε τις περιγραφές, τα ονόματα και την τυποποίηση των εργαλείων σας
- Κάντε πρώτα τοπικό έλεγχο με το ngrok και το MCP Inspector πριν την ανάπτυξη
- Τα Hugging Face Spaces προσφέρουν ιδανική δωρεάν φιλοξενία για διακομιστές MCP
- Προτιμήστε εργαλεία τύπου ροής εργασίας αντί για υπερβολικά λεπτομερή
- Προστατέψτε τα μυστικά σας και εξετάστε το ενδεχόμενο πιστοποίησης για τους διακομιστές σας