Skip to content

Latest commit

 

History

History
272 lines (173 loc) · 21.6 KB

README.md

File metadata and controls

272 lines (173 loc) · 21.6 KB

Πρακτική Εφαρμογή

Πώς να Δημιουργήσετε, Δοκιμάσετε και Αναπτύξετε Εφαρμογές MCP με Πραγματικά Εργαλεία και Ροές Εργασίας

(Κάντε κλικ στην εικόνα παραπάνω για να δείτε το βίντεο αυτού του μαθήματος)

Η πρακτική εφαρμογή είναι το σημείο όπου η δύναμη του Model Context Protocol (MCP) γίνεται απτή. Ενώ η κατανόηση της θεωρίας και της αρχιτεκτονικής πίσω από το MCP είναι σημαντική, η πραγματική αξία προκύπτει όταν εφαρμόζετε αυτές τις έννοιες για να δημιουργήσετε, να δοκιμάσετε και να αναπτύξετε λύσεις που επιλύουν προβλήματα του πραγματικού κόσμου. Αυτό το κεφάλαιο γεφυρώνει το χάσμα μεταξύ θεωρητικής γνώσης και πρακτικής ανάπτυξης, καθοδηγώντας σας στη διαδικασία δημιουργίας εφαρμογών βασισμένων στο MCP.

Είτε αναπτύσσετε έξυπνους βοηθούς, ενσωματώνετε AI σε επιχειρηματικές ροές εργασίας, είτε δημιουργείτε προσαρμοσμένα εργαλεία για επεξεργασία δεδομένων, το MCP παρέχει μια ευέλικτη βάση. Ο σχεδιασμός του που είναι ανεξάρτητος από τη γλώσσα και τα επίσημα SDK για δημοφιλείς γλώσσες προγραμματισμού το καθιστούν προσβάσιμο σε ένα ευρύ φάσμα προγραμματιστών. Χρησιμοποιώντας αυτά τα SDK, μπορείτε να δημιουργήσετε γρήγορα πρωτότυπα, να επαναλάβετε και να κλιμακώσετε τις λύσεις σας σε διαφορετικές πλατφόρμες και περιβάλλοντα.

Στις επόμενες ενότητες, θα βρείτε πρακτικά παραδείγματα, δείγματα κώδικα και στρατηγικές ανάπτυξης που δείχνουν πώς να εφαρμόσετε το MCP σε C#, Java με Spring, TypeScript, JavaScript και Python. Θα μάθετε επίσης πώς να κάνετε αποσφαλμάτωση και δοκιμή των MCP servers, να διαχειρίζεστε APIs και να αναπτύσσετε λύσεις στο cloud χρησιμοποιώντας το Azure. Αυτοί οι πρακτικοί πόροι έχουν σχεδιαστεί για να επιταχύνουν τη μάθησή σας και να σας βοηθήσουν να δημιουργήσετε με αυτοπεποίθηση ισχυρές, έτοιμες για παραγωγή εφαρμογές MCP.

Επισκόπηση

Αυτό το μάθημα επικεντρώνεται στις πρακτικές πτυχές της εφαρμογής του MCP σε πολλές γλώσσες προγραμματισμού. Θα εξερευνήσουμε πώς να χρησιμοποιήσουμε τα MCP SDKs σε C#, Java με Spring, TypeScript, JavaScript και Python για να δημιουργήσουμε ισχυρές εφαρμογές, να κάνουμε αποσφαλμάτωση και δοκιμή των MCP servers και να δημιουργήσουμε επαναχρησιμοποιήσιμους πόρους, προτροπές και εργαλεία.

Στόχοι Μάθησης

Μέχρι το τέλος αυτού του μαθήματος, θα μπορείτε να:

  • Εφαρμόσετε λύσεις MCP χρησιμοποιώντας επίσημα SDKs σε διάφορες γλώσσες προγραμματισμού
  • Κάνετε συστηματική αποσφαλμάτωση και δοκιμή των MCP servers
  • Δημιουργήσετε και να χρησιμοποιήσετε χαρακτηριστικά server (Πόροι, Προτροπές και Εργαλεία)
  • Σχεδιάσετε αποτελεσματικές ροές εργασίας MCP για σύνθετες εργασίες
  • Βελτιστοποιήσετε τις εφαρμογές MCP για απόδοση και αξιοπιστία

Επίσημοι Πόροι SDK

Το Model Context Protocol προσφέρει επίσημα SDKs για πολλές γλώσσες:

Εργασία με MCP SDKs

Αυτή η ενότητα παρέχει πρακτικά παραδείγματα εφαρμογής του MCP σε πολλές γλώσσες προγραμματισμού. Μπορείτε να βρείτε δείγματα κώδικα στον κατάλογο samples οργανωμένα ανά γλώσσα.

Διαθέσιμα Δείγματα

Το αποθετήριο περιλαμβάνει δείγματα εφαρμογών στις ακόλουθες γλώσσες:

Κάθε δείγμα δείχνει βασικές έννοιες MCP και μοτίβα εφαρμογής για τη συγκεκριμένη γλώσσα και οικοσύστημα.

Βασικά Χαρακτηριστικά Server

Οι MCP servers μπορούν να εφαρμόσουν οποιονδήποτε συνδυασμό αυτών των χαρακτηριστικών:

Πόροι

Οι πόροι παρέχουν πλαίσιο και δεδομένα για χρήση από τον χρήστη ή το μοντέλο AI:

  • Αποθετήρια εγγράφων
  • Βάσεις γνώσεων
  • Δομημένες πηγές δεδομένων
  • Συστήματα αρχείων

Προτροπές

Οι προτροπές είναι προκαθορισμένα μηνύματα και ροές εργασίας για τους χρήστες:

  • Προκαθορισμένα πρότυπα συνομιλίας
  • Καθοδηγούμενα μοτίβα αλληλεπίδρασης
  • Εξειδικευμένες δομές διαλόγου

Εργαλεία

Τα εργαλεία είναι λειτουργίες που εκτελεί το μοντέλο AI:

  • Εργαλεία επεξεργασίας δεδομένων
  • Ενσωματώσεις εξωτερικών APIs
  • Υπολογιστικές δυνατότητες
  • Λειτουργικότητα αναζήτησης

Δείγματα Εφαρμογών: Εφαρμογή σε C#

Το επίσημο αποθετήριο C# SDK περιέχει αρκετά δείγματα εφαρμογών που δείχνουν διαφορετικές πτυχές του MCP:

  • Βασικός Πελάτης MCP: Απλό παράδειγμα που δείχνει πώς να δημιουργήσετε έναν πελάτη MCP και να καλέσετε εργαλεία
  • Βασικός Server MCP: Ελάχιστη εφαρμογή server με βασική εγγραφή εργαλείων
  • Προχωρημένος Server MCP: Πλήρης server με εγγραφή εργαλείων, αυθεντικοποίηση και χειρισμό σφαλμάτων
  • Ενσωμάτωση με ASP.NET: Παραδείγματα που δείχνουν ενσωμάτωση με ASP.NET Core
  • Μοτίβα Εφαρμογής Εργαλείων: Διάφορα μοτίβα για την εφαρμογή εργαλείων με διαφορετικά επίπεδα πολυπλοκότητας

Το MCP C# SDK είναι σε προεπισκόπηση και οι APIs μπορεί να αλλάξουν. Θα ενημερώνουμε συνεχώς αυτό το blog καθώς εξελίσσεται το SDK.

Βασικά Χαρακτηριστικά

Για πλήρη δείγματα εφαρμογών σε C#, επισκεφθείτε το επίσημο αποθετήριο δειγμάτων C# SDK

Δείγμα Εφαρμογής: Εφαρμογή σε Java με Spring

Το Java με Spring SDK προσφέρει ισχυρές επιλογές εφαρμογής MCP με χαρακτηριστικά επιχειρηματικής κλάσης.

Βασικά Χαρακτηριστικά

  • Ενσωμάτωση με το Spring Framework
  • Ισχυρή ασφάλεια τύπων
  • Υποστήριξη αντιδραστικού προγραμματισμού
  • Ολοκληρωμένος χειρισμός σφαλμάτων

Για πλήρες δείγμα εφαρμογής Java με Spring, δείτε το Java με Spring δείγμα στον κατάλογο δειγμάτων.

Δείγμα Εφαρμογής: Εφαρμογή σε JavaScript

Το JavaScript SDK παρέχει μια ελαφριά και ευέλικτη προσέγγιση για την εφαρμογή MCP.

Βασικά Χαρακτηριστικά

  • Υποστήριξη Node.js και browser
  • API βασισμένο σε υποσχέσεις
  • Εύκολη ενσωμάτωση με Express και άλλα frameworks
  • Υποστήριξη WebSocket για streaming

Για πλήρες δείγμα εφαρμογής JavaScript, δείτε το JavaScript δείγμα στον κατάλογο δειγμάτων.

Δείγμα Εφαρμογής: Εφαρμογή σε Python

Το Python SDK προσφέρει μια Pythonic προσέγγιση για την εφαρμογή MCP με εξαιρετικές ενσωματώσεις ML.

Βασικά Χαρακτηριστικά

  • Υποστήριξη async/await με asyncio
  • Ενσωμάτωση με FastAPI
  • Απλή εγγραφή εργαλείων
  • Εγγενής ενσωμάτωση με δημοφιλείς βιβλιοθήκες ML

Για πλήρες δείγμα εφαρμογής Python, δείτε το Python δείγμα στον κατάλογο δειγμάτων.

Διαχείριση API

Το Azure API Management είναι μια εξαιρετική λύση για την ασφάλεια των MCP Servers. Η ιδέα είναι να τοποθετήσετε μια παρουσία Azure API Management μπροστά από τον MCP Server σας και να αφήσετε να χειριστεί χαρακτηριστικά που πιθανότατα θέλετε όπως:

  • περιορισμός ρυθμού
  • διαχείριση token
  • παρακολούθηση
  • εξισορρόπηση φορτίου
  • ασφάλεια

Δείγμα Azure

Εδώ είναι ένα δείγμα Azure που κάνει ακριβώς αυτό, δηλαδή δημιουργία MCP Server και ασφάλισή του με Azure API Management.

Δείτε πώς συμβαίνει η ροή εξουσιοδότησης στην παρακάτω εικόνα:

APIM-MCP

Στην προηγούμενη εικόνα, συμβαίνουν τα εξής:

  • Η αυθεντικοποίηση/εξουσιοδότηση πραγματοποιείται χρησιμοποιώντας το Microsoft Entra.
  • Το Azure API Management λειτουργεί ως πύλη και χρησιμοποιεί πολιτικές για να κατευθύνει και να διαχειρίζεται την κυκλοφορία.
  • Το Azure Monitor καταγράφει όλα τα αιτήματα για περαιτέρω ανάλυση.

Ροή Εξουσιοδότησης

Ας δούμε τη ροή εξουσιοδότησης πιο αναλυτικά:

Διάγραμμα Ακολουθίας

Προδιαγραφή Εξουσιοδότησης MCP

Μάθετε περισσότερα για την Προδιαγραφή Εξουσιοδότησης MCP

Ανάπτυξη Απομακρυσμένου MCP Server στο Azure

Ας δούμε αν μπορούμε να αναπτύξουμε το δείγμα που αναφέραμε νωρίτερα:

  1. Κλωνοποιήστε το αποθετήριο

    git clone https://github.com/Azure-Samples/remote-mcp-apim-functions-python.git
cd remote-mcp-apim-functions-python

  2. Εγγραφείτε στον πάροχο πόρων Microsoft.App.

    • Εάν χρησιμοποιείτε το Azure CLI, εκτελέστε az provider register --namespace Microsoft.App --wait.
    • Εάν χρησιμοποιείτε το Azure PowerShell, εκτελέστε Register-AzResourceProvider -ProviderNamespace Microsoft.App. Στη συνέχεια, εκτελέστε (Get-AzResourceProvider -ProviderNamespace Microsoft.App).RegistrationState μετά από λίγο για να ελέγξετε αν η εγγραφή έχει ολοκληρωθεί.

  3. Εκτελέστε αυτήν την εντολή azd για να προμηθεύσετε την υπηρεσία διαχείρισης API, την εφαρμογή λειτουργιών (με κώδικα) και όλους τους άλλους απαιτούμενους πόρους Azure

    azd up

    Αυτή η εντολή θα πρέπει να αναπτύξει όλους τους πόρους cloud στο Azure

Δοκιμή του server σας με MCP Inspector

  1. Σε ένα νέο παράθυρο τερματικού, εγκαταστήστε και εκτελέστε το MCP Inspector

    npx @modelcontextprotocol/inspector

    Θα πρέπει να δείτε μια διεπαφή παρόμοια με:

    Σύνδεση με Node inspector

  2. Κάντε CTRL κλικ για να φορτώσετε την web εφαρμογή MCP Inspector από τη διεύθυνση URL που εμφανίζεται από την εφαρμογή (π.χ. http://127.0.0.1:6274/#resources)

  3. Ορίστε τον τύπο μεταφοράς σε SSE

  4. Ορίστε τη διεύθυνση URL στο τρέχον API Management SSE endpoint που εμφανίζεται μετά το azd up και Συνδεθείτε:

    https://<apim-servicename-from-azd-output>.azure-api.net/mcp/sse

  5. Λίστα Εργαλείων. Κάντε κλικ σε ένα εργαλείο και Εκτελέστε Εργαλείο.

Εάν όλα τα βήματα έχουν λειτουργήσει, θα πρέπει τώρα να είστε συνδεδεμένοι στον MCP server και να έχετε καλέσει ένα εργαλείο.

MCP servers για Azure

Remote-mcp-functions: Αυτά τα αποθετήρια είναι πρότυπα γρήγορης εκκίνησης για τη δημιουργία και την ανάπτυξη προσαρμοσμένων απομακρυσμένων MCP (Model Context Protocol) servers χρησιμοποιώντας Azure Functions με Python, C# .NET ή Node/TypeScript.

Τα Δείγματα παρέχουν μια πλήρη λύση που επιτρέπει στους προγραμματιστές να:

  • Δημιουργούν και εκτελούν τοπικά: Αναπτύξτε και αποσφαλματώστε έναν MCP server σε τοπικό μηχάνημα
  • Αναπτύξτε στο Azure: Αναπτύξτε εύκολα στο cloud με μια απλή εντολή azd up
  • Συνδεθείτε από πελάτες: Συνδεθείτε στον MCP server από διάφορους πελάτες, συμπεριλαμβανομένης της λειτουργίας agent του VS Code Copilot και του εργαλείου MCP Inspector

Βασικά Χαρακτηριστικά

  • Ασφάλεια από σχεδιασμό: Ο MCP server είναι ασφαλισμένος χρησιμοποιώντας κλειδιά και HTTPS
  • Επιλογές αυθεντικοποίησης: Υποστηρίζει OAuth χρησιμοποιώντας ενσωματωμένη αυθεντικοποίηση και/ή API Management
  • Απομόνωση δικτύου: Επιτρέπει την απομόνωση δικτύου χρησιμοποιώντας Azure Virtual Networks (VNET)
  • Αρχιτεκτονική χωρίς server: Χρησιμοποιεί Azure Functions για επεκτάσιμη, βασισμένη σε γεγονότα εκτέλεση
  • Τοπική ανάπτυξη: Ολοκληρωμένη υποστήριξη τοπικής ανάπτυξης και αποσφαλμάτωσης
  • Απλή ανάπτυξη: Απλοποιημένη διαδικασία ανάπτυξης στο Azure

Το αποθετήριο περιλαμβάνει όλα τα απαραίτητα αρχεία διαμόρφωσης, πηγαίο κώδικα και ορισμούς υποδομής για να ξεκινήσετε γρήγορα με μια έτοιμη για παραγωγή εφαρμογή MCP server.

Βασικά Συμπεράσματα

  • Τα MCP SDKs παρέχουν εργαλεία ειδικά για γλώσσες για την εφαρμογή ισχυρών λύσεων MCP
  • Η διαδικασία αποσφαλμάτωσης και δοκιμής είναι κρίσιμη για αξιόπιστες εφαρμογές MCP
  • Επαναχρησιμοποιήσιμα πρότυπα προτροπών επιτρέπουν συνεπείς αλληλεπιδράσεις AI
  • Καλά σχεδιασμένες ροές εργασίας μπορούν να ενορχηστρώσουν σύνθετες εργασίες χρησιμοποιώντας πολλαπλά εργαλεία
  • Η εφαρμογή λύσεων MCP απαιτεί εξέταση της ασφάλειας, της απόδοσης και του χειρισμού σφαλμάτων

Άσκηση

Σχεδιά

Αποποίηση Ευθύνης:
Αυτό το έγγραφο έχει μεταφραστεί χρησιμοποιώντας την υπηρεσία αυτόματης μετάφρασης Co-op Translator. Παρόλο που καταβάλλουμε κάθε προσπάθεια για ακρίβεια, παρακαλούμε να έχετε υπόψη ότι οι αυτόματες μεταφράσεις ενδέχεται να περιέχουν σφάλματα ή ανακρίβειες. Το πρωτότυπο έγγραφο στη μητρική του γλώσσα θα πρέπει να θεωρείται η αυθεντική πηγή. Για κρίσιμες πληροφορίες, συνιστάται επαγγελματική ανθρώπινη μετάφραση. Δεν φέρουμε ευθύνη για τυχόν παρεξηγήσεις ή εσφαλμένες ερμηνείες που προκύπτουν από τη χρήση αυτής της μετάφρασης.