Η πρακτική εφαρμογή είναι το σημείο όπου η δύναμη του Model Context Protocol (MCP) γίνεται απτή. Ενώ η κατανόηση της θεωρίας και της αρχιτεκτονικής πίσω από το MCP είναι σημαντική, η πραγματική αξία προκύπτει όταν εφαρμόζετε αυτές τις έννοιες για να δημιουργήσετε, να δοκιμάσετε και να αναπτύξετε λύσεις που επιλύουν πραγματικά προβλήματα. Αυτό το κεφάλαιο γεφυρώνει το χάσμα μεταξύ της εννοιολογικής γνώσης και της πρακτικής ανάπτυξης, καθοδηγώντας σας στη διαδικασία υλοποίησης εφαρμογών βασισμένων στο MCP.
Είτε αναπτύσσετε έξυπνους βοηθούς, ενσωματώνετε AI σε επιχειρησιακές ροές εργασίας, είτε δημιουργείτε προσαρμοσμένα εργαλεία για επεξεργασία δεδομένων, το MCP παρέχει μια ευέλικτη βάση. Ο σχεδιασμός του που δεν εξαρτάται από γλώσσα προγραμματισμού και τα επίσημα SDK για δημοφιλείς γλώσσες το καθιστούν προσβάσιμο σε ένα ευρύ φάσμα προγραμματιστών. Αξιοποιώντας αυτά τα SDK, μπορείτε γρήγορα να δημιουργήσετε πρωτότυπα, να επαναλάβετε και να κλιμακώσετε τις λύσεις σας σε διαφορετικές πλατφόρμες και περιβάλλοντα.
Στις επόμενες ενότητες, θα βρείτε πρακτικά παραδείγματα, δείγματα κώδικα και στρατηγικές ανάπτυξης που δείχνουν πώς να υλοποιήσετε το MCP σε C#, Java, TypeScript, JavaScript και Python. Θα μάθετε επίσης πώς να εντοπίζετε σφάλματα και να δοκιμάζετε τους MCP servers σας, να διαχειρίζεστε APIs και να αναπτύσσετε λύσεις στο cloud χρησιμοποιώντας το Azure. Αυτοί οι πρακτικοί πόροι έχουν σχεδιαστεί για να επιταχύνουν τη μάθησή σας και να σας βοηθήσουν να δημιουργήσετε με αυτοπεποίθηση στιβαρές, παραγωγικές εφαρμογές MCP.
Αυτό το μάθημα εστιάζει σε πρακτικές πτυχές της υλοποίησης MCP σε πολλές γλώσσες προγραμματισμού. Θα εξερευνήσουμε πώς να χρησιμοποιήσουμε τα MCP SDK σε C#, Java, TypeScript, JavaScript και Python για να δημιουργήσουμε στιβαρές εφαρμογές, να εντοπίσουμε σφάλματα και να δοκιμάσουμε MCP servers, καθώς και να δημιουργήσουμε επαναχρησιμοποιήσιμους πόρους, prompts και εργαλεία.
Στο τέλος αυτού του μαθήματος, θα μπορείτε να:
- Υλοποιείτε λύσεις MCP χρησιμοποιώντας επίσημα SDK σε διάφορες γλώσσες προγραμματισμού
- Εντοπίζετε σφάλματα και δοκιμάζετε συστηματικά MCP servers
- Δημιουργείτε και χρησιμοποιείτε λειτουργίες server (Resources, Prompts και Tools)
- Σχεδιάζετε αποτελεσματικές ροές εργασίας MCP για σύνθετες εργασίες
- Βελτιστοποιείτε τις υλοποιήσεις MCP για απόδοση και αξιοπιστία
Το Model Context Protocol προσφέρει επίσημα SDK για πολλές γλώσσες:
Αυτή η ενότητα παρέχει πρακτικά παραδείγματα υλοποίησης MCP σε πολλές γλώσσες προγραμματισμού. Μπορείτε να βρείτε δείγματα κώδικα στον φάκελο samples οργανωμένα ανά γλώσσα.
Το αποθετήριο περιλαμβάνει δείγματα υλοποίησης στις εξής γλώσσες:
Κάθε δείγμα παρουσιάζει βασικές έννοιες MCP και πρότυπα υλοποίησης για τη συγκεκριμένη γλώσσα και οικοσύστημα.
Οι MCP servers μπορούν να υλοποιήσουν οποιονδήποτε συνδυασμό από τις παρακάτω λειτουργίες:
Οι Resources παρέχουν πλαίσιο και δεδομένα για χρήση από τον χρήστη ή το μοντέλο AI:
- Αποθετήρια εγγράφων
- Βάσεις γνώσης
- Δομημένες πηγές δεδομένων
- Συστήματα αρχείων
Τα Prompts είναι προτυπωμένα μηνύματα και ροές εργασίας για τους χρήστες:
- Προκαθορισμένα πρότυπα συνομιλίας
- Καθοδηγούμενα μοτίβα αλληλεπίδρασης
- Εξειδικευμένες δομές διαλόγου
Τα Tools είναι λειτουργίες που εκτελεί το μοντέλο AI:
- Εργαλεία επεξεργασίας δεδομένων
- Ενσωματώσεις εξωτερικών API
- Υπολογιστικές δυνατότητες
- Λειτουργίες αναζήτησης
Το επίσημο αποθετήριο C# SDK περιέχει αρκετά δείγματα που παρουσιάζουν διαφορετικές πτυχές του MCP:
- Basic MCP Client: Απλό παράδειγμα που δείχνει πώς να δημιουργήσετε έναν MCP client και να καλέσετε εργαλεία
- Basic MCP Server: Ελάχιστη υλοποίηση server με βασική εγγραφή εργαλείων
- Advanced MCP Server: Πλήρης server με εγγραφή εργαλείων, αυθεντικοποίηση και διαχείριση σφαλμάτων
- ASP.NET Integration: Παραδείγματα ενσωμάτωσης με ASP.NET Core
- Tool Implementation Patterns: Διάφορα πρότυπα για υλοποίηση εργαλείων με διαφορετικά επίπεδα πολυπλοκότητας
Το MCP C# SDK βρίσκεται σε προεπισκόπηση και οι APIs ενδέχεται να αλλάξουν. Θα ενημερώνουμε συνεχώς αυτό το blog καθώς το SDK εξελίσσεται.
-
Δημιουργία του πρώτου MCP Server.
Για πλήρη δείγματα υλοποίησης σε C#, επισκεφθείτε το επίσημο αποθετήριο δειγμάτων C# SDK
Το Java SDK προσφέρει στιβαρές επιλογές υλοποίησης MCP με χαρακτηριστικά επιπέδου επιχείρησης.
- Ενσωμάτωση με Spring Framework
- Ισχυρή ασφάλεια τύπων
- Υποστήριξη αντιδραστικού προγραμματισμού
- Ολοκληρωμένη διαχείριση σφαλμάτων
Για πλήρες παράδειγμα υλοποίησης σε Java, δείτε το Java sample στον φάκελο δειγμάτων.
Το JavaScript SDK παρέχει μια ελαφριά και ευέλικτη προσέγγιση στην υλοποίηση MCP.
- Υποστήριξη Node.js και browser
- Promise-based API
- Εύκολη ενσωμάτωση με Express και άλλα frameworks
- Υποστήριξη WebSocket για streaming
Για πλήρες παράδειγμα υλοποίησης σε JavaScript, δείτε το JavaScript sample στον φάκελο δειγμάτων.
Το Python SDK προσφέρει μια Python-κεντρική προσέγγιση στην υλοποίηση MCP με εξαιρετικές ενσωματώσεις σε ML frameworks.
- Υποστήριξη async/await με asyncio
- Ενσωμάτωση FastAPI
- Απλή εγγραφή εργαλείων
- Φυσική ενσωμάτωση με δημοφιλείς βιβλιοθήκες ML
Για πλήρες παράδειγμα υλοποίησης σε Python, δείτε το Python sample στον φάκελο δειγμάτων.
Το Azure API Management είναι μια εξαιρετική λύση για το πώς μπορούμε να ασφαλίσουμε τους MCP Servers. Η ιδέα είναι να τοποθετήσετε μια υπηρεσία Azure API Management μπροστά από τον MCP Server σας και να αφήσετε αυτήν να διαχειρίζεται λειτουργίες που πιθανόν να χρειαστείτε, όπως:
- περιορισμός ρυθμού (rate limiting)
- διαχείριση tokens
- παρακολούθηση
- ισορροπία φορτίου
- ασφάλεια
Εδώ υπάρχει ένα παράδειγμα Azure που κάνει ακριβώς αυτό, δηλαδή δημιουργεί έναν MCP Server και τον ασφαλίζει με Azure API Management.
Δείτε πώς γίνεται η ροή εξουσιοδότησης στην παρακάτω εικόνα:
Στην παραπάνω εικόνα, συμβαίνουν τα εξής:
- Η αυθεντικοποίηση/εξουσιοδότηση γίνεται μέσω Microsoft Entra.
- Το Azure API Management λειτουργεί ως πύλη και χρησιμοποιεί πολιτικές για να κατευθύνει και να διαχειρίζεται την κίνηση.
- Το Azure Monitor καταγράφει όλα τα αιτήματα για περαιτέρω ανάλυση.
Ας δούμε πιο αναλυτικά τη ροή εξουσιοδότησης:
Μάθετε περισσότερα για την προδιαγραφή εξουσιοδότησης MCP
Ας δούμε αν μπορούμε να αναπτύξουμε το παράδειγμα που αναφέραμε νωρίτερα:
-
Κλωνοποιήστε το αποθετήριο
git clone https://github.com/Azure-Samples/remote-mcp-apim-functions-python.git cd remote-mcp-apim-functions-python -
Εγγραφείτε στον πάροχο πόρων
Microsoft.App.- Αν χρησιμοποιείτε Azure CLI, εκτελέστε
az provider register --namespace Microsoft.App --wait. - Αν χρησιμοποιείτε Azure PowerShell, εκτελέστε
Register-AzResourceProvider -ProviderNamespace Microsoft.App. Στη συνέχεια, εκτελέστε(Get-AzResourceProvider -ProviderNamespace Microsoft.App).RegistrationStateμετά από λίγο για να ελέγξετε αν ολοκληρώθηκε η εγγραφή.
- Αν χρησιμοποιείτε Azure CLI, εκτελέστε
-
Εκτελέστε αυτή την εντολή azd για να προμηθευτείτε την υπηρεσία διαχείρισης API, την εφαρμογή λειτουργιών (με κώδικα) και όλους τους άλλους απαραίτητους πόρους Azure
azd up
Αυτή η εντολή θα αναπτύξει όλους τους πόρους στο cloud του Azure
-
Σε ένα νέο παράθυρο τερματικού, εγκαταστήστε και εκτελέστε το MCP Inspector
npx @modelcontextprotocol/inspector
Θα δείτε μια διεπαφή παρόμοια με:
-
Πατήστε CTRL και κάντε κλικ για να φορτώσετε την web εφαρμογή MCP Inspector από το URL που εμφανίζει η εφαρμογή (π.χ. http://127.0.0.1:6274/#resources)
-
Ορίστε τον τύπο μεταφοράς σε
SSE -
Ορίστε το URL στο τρέχον API Management SSE endpoint που εμφανίστηκε μετά το
azd upκαι Συνδεθείτε:https://<apim-servicename-from-azd-output>.azure-api.net/mcp/sse
-
Λίστα Εργαλείων. Κάντε κλικ σε ένα εργαλείο και επιλέξτε Εκτέλεση Εργαλείου.
Αν όλα τα βήματα έγιναν σωστά, τώρα θα είστε συνδεδεμένοι με τον MCP server και θα έχετε καταφέρει να καλέσετε ένα εργαλείο.
Remote-mcp-functions: Αυτό το σύνολο αποθετηρίων είναι πρότυπα γρήγορης εκκίνησης για την κατασκευή και ανάπτυξη προσαρμοσμένων απομακρυσμένων MCP (Model Context Protocol) servers χρησιμοποιώντας Azure Functions με Python, C# .NET ή Node/TypeScript.
Τα δείγματα παρέχουν μια ολοκληρωμένη λύση που επιτρέπει στους προγραμματιστές να:
- Δημιουργούν και τρέχουν τοπικά: Αναπτύσσουν και εντοπίζουν σφάλματα σε MCP server σε τοπικό μηχάνημα
- Αναπτύσσουν στο Azure: Αναπτύσσουν εύκολα στο cloud με μια απλή εντολή azd up
- Συνδέονται από πελάτες: Συνδέονται με τον MCP server από διάφορους πελάτες, συμπεριλαμβανομένης της λειτουργίας agent Copilot του VS Code και του εργαλείου MCP Inspector
- Ασφάλεια από σχεδιασμό: Ο MCP server ασφαλίζεται με κλειδιά και HTTPS
- Επιλογές αυθεντικοποίησης: Υποστηρίζει OAuth με ενσωματωμένη αυθεντικοποίηση και/ή API Management
- Απομόνωση δικτύου: Επιτρέπει απομόνωση δικτύου με Azure Virtual Networks (VNET)
- Αρχιτεκτονική χωρίς server: Χρησιμοποιεί Azure Functions για κλιμακούμενη, event-driven εκτέλεση
- Τοπική ανάπτυξη: Ολοκληρωμένη υποστήριξη τοπικής ανάπτυξης και εντοπισμού σφαλμάτων
- Απλή ανάπτυξη: Απλοποιημένη διαδικασία ανάπτυξης στο Azure
Το αποθετήριο περιλαμβάνει όλα τα απαραίτητα αρχεία ρυθμίσεων, πηγαίο κώδικα και ορισμούς υποδομής για να ξεκινήσετε γρήγορα με μια παραγωγική υλοποίηση MCP server.
-
Azure Remote MCP Functions Python - Παράδειγμα υλοποίησης MCP με Azure Functions και Python
-
Azure Remote MCP Functions .NET - Παράδειγμα υλοποίησης MCP με Azure Functions και C# .NET
-
Azure Remote MCP Functions Node/Typescript - Παράδειγμα υλοποίησης MCP με Azure Functions και Node/TypeScript.
- Τα MCP SDK παρέχουν γλωσσικά εξειδικευμένα εργαλεία για την υλοποίηση στιβαρών λύσεων MCP
- Η διαδικασία εντοπισμού σφαλμάτων και δοκιμών είναι κρίσιμη για αξιόπιστες εφαρμογές MCP
- Τα επαναχρησιμοποιήσιμα πρότυπα prompt επιτρέπουν συνεπείς αλληλεπιδράσεις με το AI
- Οι καλά σχεδιασμένες ροές εργασίας μπορούν να οργανώσουν σύνθετες εργασίες χρησιμοποιώντας πολλαπλά εργαλεία
- Η υλοποίηση λύσεων MCP απαιτεί προσοχή στην ασφάλεια, την απόδοση και τη διαχείριση σφαλμάτων
Σχεδιάστε μια πρακτική ροή εργασίας MCP που να αντιμετωπίζει ένα πραγματικό πρόβλημα στον τομέα σας:
- Εντοπίστε 3-4 εργαλεία που θα ήταν χρήσιμα για την επίλυση αυτού του προβλήματος
- Δημιουργήστε ένα διάγραμμα ροής που να δείχνει πώς αλληλεπιδρούν αυτά τα εργαλεία
- Υλοποιήστε μια βασική έκδοση ενός από τα εργαλεία χρησιμοποιώντας την προτιμώμενη γλώσσα σας
- Δημιουργήστε ένα πρότυπο prompt που θα βοηθά το μοντέλο να χρησιμοποιεί αποτελεσματικά το εργαλείο σας
Επόμενο: Advanced Topics
Αποποίηση ευθυνών:
Αυτό το έγγραφο έχει μεταφραστεί χρησιμοποιώντας την υπηρεσία αυτόματης μετάφρασης AI Co-op Translator. Παρόλο που επιδιώκουμε την ακρίβεια, παρακαλούμε να γνωρίζετε ότι οι αυτόματες μεταφράσεις ενδέχεται να περιέχουν λάθη ή ανακρίβειες. Το πρωτότυπο έγγραφο στη γλώσσα του θεωρείται η αυθεντική πηγή. Για κρίσιμες πληροφορίες, συνιστάται επαγγελματική ανθρώπινη μετάφραση. Δεν φέρουμε ευθύνη για τυχόν παρεξηγήσεις ή λανθασμένες ερμηνείες που προκύπτουν από τη χρήση αυτής της μετάφρασης.