MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

Ακολουθήστε αυτά τα βήματα για να ξεκινήσετε να χρησιμοποιείτε αυτούς τους πόρους:

  1. Κάντε Fork το Repository: Πατήστε GitHub forks
  2. Κλωνοποιήστε το Repository: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Γίνετε μέλος στο Azure AI Foundry Discord και γνωρίστε ειδικούς και άλλους προγραμματιστές

🌐 Υποστήριξη Πολλαπλών Γλωσσών

Υποστηρίζεται μέσω GitHub Action (Αυτοματοποιημένο & Πάντα Ενημερωμένο)

Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Korean | Malay | Marathi | Nepali | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Thai | Turkish | Ukrainian | Urdu | Vietnamese

🚀 Εκπαιδευτικό Υλικό για το Model Context Protocol (MCP) για Αρχάριους

Μάθετε MCP με Παραδείγματα Κώδικα σε C#, Java, JavaScript, Rust, Python και TypeScript

🧠 Επισκόπηση του Εκπαιδευτικού Υλικού για το Model Context Protocol

Το Model Context Protocol (MCP) είναι ένα πρωτοποριακό πλαίσιο που έχει σχεδιαστεί για να τυποποιεί τις αλληλεπιδράσεις μεταξύ μοντέλων AI και εφαρμογών πελατών. Αυτό το εκπαιδευτικό υλικό ανοιχτού κώδικα προσφέρει μια δομημένη πορεία μάθησης, με πρακτικά παραδείγματα κώδικα και πραγματικές περιπτώσεις χρήσης, σε δημοφιλείς γλώσσες προγραμματισμού όπως C#, Java, JavaScript, TypeScript και Python.

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

🔗 Επίσημοι Πόροι MCP

🧭 Επισκόπηση Εκπαιδευτικού Υλικού MCP

📚 Πλήρης Δομή Εκπαιδευτικού Υλικού

ΕνότηταΘέμαΠεριγραφήΣύνδεσμος
Ενότητα 1-3: Βασικά Στοιχεία
00Εισαγωγή στο MCPΕπισκόπηση του Model Context Protocol και της σημασίας του στις διαδικασίες AIΔιαβάστε περισσότερα
01Επεξήγηση Βασικών ΕννοιώνΛεπτομερής ανάλυση των βασικών εννοιών του MCPΔιαβάστε περισσότερα
02Ασφάλεια στο MCPΑπειλές ασφαλείας και βέλτιστες πρακτικέςΔιαβάστε περισσότερα
03Ξεκινώντας με το MCPΡύθμιση περιβάλλοντος, βασικοί servers/clients, ενσωμάτωσηΔιαβάστε περισσότερα
Ενότητα 3: Δημιουργία του Πρώτου Server & Client
3.1Πρώτος ServerΔημιουργήστε τον πρώτο σας MCP serverΟδηγός
3.2Πρώτος ClientΑναπτύξτε έναν βασικό MCP clientΟδηγός
3.3Client με LLMΕνσωματώστε μεγάλα γλωσσικά μοντέλαΟδηγός
3.4Ενσωμάτωση με VS CodeΧρησιμοποιήστε MCP servers στο VS CodeΟδηγός
3.5stdio ServerΔημιουργήστε servers χρησιμοποιώντας μεταφορά stdioΟδηγός
3.6HTTP StreamingΥλοποιήστε HTTP streaming στο MCPΟδηγός
3.7AI ToolkitΧρησιμοποιήστε το AI Toolkit με MCPΟδηγός
3.8ΔοκιμέςΔοκιμάστε την υλοποίηση του MCP server σαςΟδηγός
3.9ΑνάπτυξηΑναπτύξτε MCP servers σε παραγωγήΟδηγός
3.10Προχωρημένη χρήση serverΧρησιμοποιήστε προχωρημένους servers για βελτιωμένη αρχιτεκτονική και δυνατότητεςΟδηγός
3.11Απλή αυθεντικοποίησηΚεφάλαιο που δείχνει αυθεντικοποίηση από την αρχή και RBACΟδηγός
Ενότητα 4-5: Πρακτική & Προχωρημένα Θέματα
04Πρακτική ΥλοποίησηSDKs, debugging, testing, επαναχρησιμοποιήσιμα πρότυπα προτροπώνΔιαβάστε περισσότερα
05Προχωρημένα Θέματα στο MCPΠολυτροπικό AI, κλιμάκωση, χρήση σε επιχειρήσειςΔιαβάστε περισσότερα
5.1Ενσωμάτωση με AzureΕνσωμάτωση MCP με AzureΟδηγός
5.2ΠολυτροπικότηταΕργασία με πολλαπλές τροπικότητεςΟδηγός
5.3Επίδειξη OAuth2Υλοποίηση αυθεντικοποίησης OAuth2Οδηγός
5.4Root ContextsΚατανόηση και υλοποίηση root contextsΟδηγός
5.5ΔρομολόγησηΣτρατηγικές δρομολόγησης MCPΟδηγός
5.6ΔειγματοληψίαΤεχνικές δειγματοληψίας στο MCPΟδηγός
5.7ΚλιμάκωσηΚλιμάκωση υλοποιήσεων MCPΟδηγός
5.8ΑσφάλειαΠροχωρημένες σκέψεις για την ασφάλειαΟδηγός
5.9Αναζήτηση στο WebΥλοποίηση δυνατοτήτων αναζήτησης στο webΟδηγός
5.10Ροή σε πραγματικό χρόνοΔημιουργία λειτουργικότητας ροής σε πραγματικό χρόνοΟδηγός
5.11Αναζήτηση σε πραγματικό χρόνοΥλοποίηση αναζήτησης σε πραγματικό χρόνοΟδηγός
5.12Αυθεντικοποίηση με Entra IDΑυθεντικοποίηση με Microsoft Entra IDΟδηγός
5.13Ενσωμάτωση με FoundryΕνσωμάτωση με Azure AI FoundryΟδηγός
5.14Μηχανική ContextΤεχνικές για αποτελεσματική μηχανική contextΟδηγός
5.15Προσαρμοσμένη Μεταφορά MCPΥλοποιήσεις προσαρμοσμένης μεταφοράςΟδηγός
Ενότητα 6-10: Κοινότητα & Βέλτιστες Πρακτικές
06Συνεισφορές ΚοινότηταςΠώς να συμβάλετε στο οικοσύστημα MCPΟδηγός
07Μαθήματα από Πρώιμη ΥιοθέτησηΙστορίες πραγματικής υλοποίησηςΟδηγός
08Βέλτιστες Πρακτικές για MCPΑπόδοση, ανοχή σε σφάλματα, ανθεκτικότηταΟδηγός
09Μελέτες Περίπτωσης MCPΠαραδείγματα πρακτικής υλοποίησηςΟδηγός
10Εργαστήριο ΠρακτικήςΔημιουργία MCP Server με AI ToolkitΕργαστήριο
Ενότητα 11: Εργαστήριο MCP Server
11Ενσωμάτωση MCP Server με Βάση ΔεδομένωνΟλοκληρωμένη πορεία 13 εργαστηρίων για ενσωμάτωση με PostgreSQLΕργαστήρια
11.1ΕισαγωγήΕπισκόπηση του MCP με ενσωμάτωση βάσης δεδομένων και χρήση αναλυτικών δεδομένων λιανικήςΕργαστήριο 00
11.2Βασική ΑρχιτεκτονικήΚατανόηση της αρχιτεκτονικής του διακομιστή MCP, των επιπέδων βάσης δεδομένων και των προτύπων ασφαλείαςΕργαστήριο 01
11.3Ασφάλεια & ΠολυενοικίασηΑσφάλεια σε επίπεδο γραμμής, αυθεντικοποίηση και πρόσβαση σε δεδομένα πολλαπλών ενοικιαστώνΕργαστήριο 02
11.4Ρύθμιση ΠεριβάλλοντοςΡύθμιση περιβάλλοντος ανάπτυξης, Docker, πόροι AzureΕργαστήριο 03
11.5Σχεδιασμός Βάσης ΔεδομένωνΡύθμιση PostgreSQL, σχεδιασμός σχήματος λιανικής και δείγματα δεδομένωνΕργαστήριο 04
11.6Υλοποίηση Διακομιστή MCPΔημιουργία του διακομιστή FastMCP με ενσωμάτωση βάσης δεδομένωνΕργαστήριο 05
11.7Ανάπτυξη ΕργαλείωνΔημιουργία εργαλείων ερωτημάτων βάσης δεδομένων και ανάλυση σχήματοςΕργαστήριο 06
11.8Σημασιολογική ΑναζήτησηΥλοποίηση ενσωματώσεων διανυσμάτων με Azure OpenAI και pgvectorΕργαστήριο 07
11.9Δοκιμές & Εντοπισμός ΣφαλμάτωνΣτρατηγικές δοκιμών, εργαλεία εντοπισμού σφαλμάτων και προσεγγίσεις επαλήθευσηςΕργαστήριο 08
11.10Ενσωμάτωση με VS CodeΡύθμιση ενσωμάτωσης MCP στο VS Code και χρήση AI ChatΕργαστήριο 09
11.11Στρατηγικές ΑνάπτυξηςΑνάπτυξη με Docker, Azure Container Apps και θέματα κλιμάκωσηςΕργαστήριο 10
11.12ΠαρακολούθησηApplication Insights, καταγραφή, παρακολούθηση απόδοσηςΕργαστήριο 11
11.13Βέλτιστες ΠρακτικέςΒελτιστοποίηση απόδοσης, ενίσχυση ασφάλειας και συμβουλές για παραγωγήΕργαστήριο 12

💻 Δείγματα Κώδικα

Βασικά Δείγματα Υπολογιστή MCP

ΓλώσσαΠεριγραφήΣύνδεσμος
C#Παράδειγμα Διακομιστή MCPΠροβολή Κώδικα
JavaΥπολογιστής MCPΠροβολή Κώδικα
JavaScriptΕπίδειξη MCPΠροβολή Κώδικα
PythonΔιακομιστής MCPΠροβολή Κώδικα
TypeScriptΠαράδειγμα MCPΠροβολή Κώδικα
RustΠαράδειγμα MCPΠροβολή Κώδικα

Προχωρημένες Υλοποιήσεις MCP

ΓλώσσαΠεριγραφήΣύνδεσμος
C#Προχωρημένο ΠαράδειγμαΠροβολή Κώδικα
Java με SpringΠαράδειγμα Εφαρμογής ContainerΠροβολή Κώδικα
JavaScriptΠροχωρημένο ΠαράδειγμαΠροβολή Κώδικα
PythonΣύνθετη ΥλοποίησηΠροβολή Κώδικα
TypeScriptΠαράδειγμα ContainerΠροβολή Κώδικα

🎯 Προαπαιτούμενα για την Εκμάθηση MCP

Για να αξιοποιήσετε στο έπακρο αυτό το πρόγραμμα σπουδών, θα πρέπει να έχετε:

  • Βασικές γνώσεις προγραμματισμού σε τουλάχιστον μία από τις ακόλουθες γλώσσες: C#, Java, JavaScript, Python ή TypeScript

  • Κατανόηση του μοντέλου πελάτη-διακομιστή και των APIs

  • Εξοικείωση με τις έννοιες REST και HTTP

  • (Προαιρετικά) Γνώσεις σε AI/ML

  • Συμμετοχή στις συζητήσεις της κοινότητάς μας για υποστήριξη

📚 Οδηγός Μελέτης & Πόροι

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

Οδηγός Μελέτης

Ένας ολοκληρωμένος Οδηγός Μελέτης είναι διαθέσιμος για να σας βοηθήσει να πλοηγηθείτε αποτελεσματικά σε αυτό το αποθετήριο. Ο οδηγός περιλαμβάνει:

  • Ένα οπτικό χάρτη του προγράμματος σπουδών που δείχνει όλα τα καλυπτόμενα θέματα
  • Λεπτομερή ανάλυση κάθε ενότητας του αποθετηρίου
  • Οδηγίες για τη χρήση των δειγμάτων έργων
  • Προτεινόμενες διαδρομές μάθησης για διαφορετικά επίπεδα δεξιοτήτων
  • Πρόσθετους πόρους για να συμπληρώσετε το ταξίδι μάθησής σας

Αρχείο Αλλαγών

Διατηρούμε ένα λεπτομερές Αρχείο Αλλαγών που καταγράφει όλες τις σημαντικές ενημερώσεις στα υλικά του προγράμματος σπουδών, όπως:

  • Νέες προσθήκες περιεχομένου
  • Δομικές αλλαγές
  • Βελτιώσεις λειτουργιών
  • Ενημερώσεις τεκμηρίωσης

🛠️ Πώς να Χρησιμοποιήσετε Αποτελεσματικά Αυτό το Πρόγραμμα Σπουδών

Κάθε μάθημα σε αυτόν τον οδηγό περιλαμβάνει:

  1. Σαφείς εξηγήσεις των εννοιών MCP
  2. Ζωντανά παραδείγματα κώδικα σε πολλές γλώσσες
  3. Ασκήσεις για την κατασκευή πραγματικών εφαρμογών MCP
  4. Επιπλέον πόρους για προχωρημένους μαθητές

Εκδηλώσεις

MCP Dev Days Ιούλιος 2025

➡️Παρακολουθήστε On Demand - MCP Dev Days

Ετοιμαστείτε για δύο ημέρες βαθιάς τεχνικής γνώσης, σύνδεσης με την κοινότητα και πρακτικής μάθησης στα MCP Dev Days, μια εικονική εκδήλωση αφιερωμένη στο Model Context Protocol (MCP) — το αναδυόμενο πρότυπο που γεφυρώνει τα μοντέλα AI και τα εργαλεία που βασίζονται σε αυτά. Μπορείτε να παρακολουθήσετε τα MCP Dev Days εγγραφόμενοι στη σελίδα της εκδήλωσης: https://aka.ms/mcpdevdays.

Ημέρα 1: Παραγωγικότητα MCP, Εργαλεία Ανάπτυξης & Κοινότητα:

Αφορά την ενδυνάμωση των προγραμματιστών να χρησιμοποιούν το MCP στη ροή εργασίας τους και τον εορτασμό της εκπληκτικής κοινότητας MCP. Θα έχουμε μαζί μας μέλη της κοινότητας και συνεργάτες όπως Arcade, Block, Okta και Neon για να δούμε πώς συνεργάζονται με τη Microsoft για να διαμορφώσουν ένα ανοιχτό, επεκτάσιμο οικοσύστημα MCP. Πραγματικά παραδείγματα σε VS Code, Visual Studio, GitHub Copilot και δημοφιλή εργαλεία κοινότητας Πρακτικές, προσανατολισμένες στο πλαίσιο ροές εργασίας ανάπτυξης Συνεδρίες και πληροφορίες από την κοινότητα Είτε ξεκινάτε τώρα με το MCP είτε ήδη δημιουργείτε με αυτό, η Ημέρα 1 θα θέσει τη βάση με έμπνευση και πρακτικές συμβουλές.

Ημέρα 2: Δημιουργία Διακομιστών MCP με Σιγουριά

Απευθύνεται στους δημιουργούς MCP. Θα εμβαθύνουμε σε στρατηγικές υλοποίησης και βέλτιστες πρακτικές για τη δημιουργία διακομιστών MCP και την ενσωμάτωση του MCP στις ροές εργασίας AI.

Θέματα περιλαμβάνουν:

  • Δημιουργία Διακομιστών MCP και ενσωμάτωσή τους σε εμπειρίες πρακτόρων
  • Ανάπτυξη με βάση προτροπές
  • Βέλτιστες πρακτικές ασφαλείας
  • Χρήση δομικών στοιχείων όπως Functions, ACA και API Management
  • Ευθυγράμμιση μητρώου και εργαλεία (1P + 3P)

Εάν είστε προγραμματιστής, δημιουργός εργαλείων ή στρατηγικός σχεδιαστής προϊόντων AI, αυτή η ημέρα είναι γεμάτη με τις πληροφορίες που χρειάζεστε για να δημιουργήσετε κλιμακούμενες, ασφαλείς και έτοιμες για το μέλλον λύσεις MCP.

MCP Boot Camp Αύγουστος 2025

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

➡️Παρακολουθήστε On Demand MCP Bootcamp | Αγγλικά

➡️Παρακολουθήστε On Demand MCP Bootcamp | Βραζιλία

➡️Παρακολουθήστε On Demand MCP Bootcamp | Ισπανικά

Ας Μάθουμε MCP με C# - Σειρά Μαθημάτων

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

C#: https://aka.ms/letslearnmcp-csharp

Java: https://aka.ms/letslearnmcp-java

JavaScript: https://aka.ms/letslearnmcp-javascript

Python: https://aka.ms/letslearnmcp-python

🌟 Ευχαριστίες στην Κοινότητα

Ευχαριστούμε τον Microsoft Valued Professional Shivam Goyal για τη συνεισφορά σημαντικών δειγμάτων κώδικα.

📜 Πληροφορίες Άδειας Χρήσης

Αυτό το περιεχόμενο είναι αδειοδοτημένο υπό την MIT License. Για όρους και προϋποθέσεις, δείτε το LICENSE.

🤝 Οδηγίες Συνεισφοράς

Αυτό το έργο καλωσορίζει συνεισφορές και προτάσεις. Οι περισσότερες συνεισφορές απαιτούν να συμφωνήσετε με μια Συμφωνία Άδειας Χρήσης Συνεισφοράς (CLA) δηλώνοντας ότι έχετε το δικαίωμα να μας παραχωρήσετε τα δικαιώματα χρήσης της συνεισφοράς σας. Για λεπτομέρειες, επισκεφθείτε https://cla.opensource.microsoft.com.

Όταν υποβάλετε ένα pull request, ένα bot CLA θα καθορίσει αυτόματα εάν χρειάζεται να παρέχετε μια CLA και θα διακοσμήσει το PR ανάλογα (π.χ., έλεγχος κατάστασης, σχόλιο). Απλώς ακολουθήστε τις οδηγίες που παρέχονται από το bot. Θα χρειαστεί να το κάνετε αυτό μόνο μία φορά για όλα τα αποθετήρια που χρησιμοποιούν την CLA μας.

Αυτό το έργο έχει υιοθετήσει τον Κώδικα Δεοντολογίας Ανοιχτού Κώδικα της Microsoft. Για περισσότερες πληροφορίες δείτε τις Συχνές Ερωτήσεις για τον Κώδικα Δεοντολογίας ή επικοινωνήστε με opencode@microsoft.com για οποιαδήποτε επιπλέον ερώτηση ή σχόλιο.

📂 Δομή Αποθετηρίου

Το αποθετήριο είναι οργανωμένο ως εξής:

  • Κύριο Πρόγραμμα Σπουδών (00-11): Το κύριο περιεχόμενο οργανωμένο σε έντεκα διαδοχικές ενότητες, συμπεριλαμβανομένων ολοκληρωμένων εργαστηρίων ενσωμάτωσης βάσης δεδομένων
  • 11-MCPServerHandsOnLabs/: Πλήρης διαδρομή μάθησης 13 εργαστηρίων για τη δημιουργία διακομιστών MCP έτοιμων για παραγωγή με ενσωμάτωση PostgreSQL
  • images/: Διαγράμματα και εικονογραφήσεις που χρησιμοποιούνται σε όλο το πρόγραμμα σπουδών
  • translations/: Υποστήριξη πολλών γλωσσών με αυτοματοποιημένες μεταφράσεις
  • translated_images/: Τοπικές εκδόσεις διαγραμμάτων και εικονογραφήσεων
  • study_guide.md: Ολοκληρωμένος οδηγός για την πλοήγηση στο αποθετήριο
  • changelog.md: Καταγραφή όλων των σημαντικών αλλαγών στα υλικά του προγράμματος σπουδών
  • mcp.json: Αρχείο ρυθμίσεων για την προδιαγραφή MCP
  • CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Έγγραφα διακυβέρνησης του έργου

🎒 Άλλα Μαθήματα

Η ομάδα μας δημιουργεί και άλλα μαθήματα! Δείτε:

™️ Ειδοποίηση Εμπορικού Σήματος

Αυτό το έργο μπορεί να περιέχει εμπορικά σήματα ή λογότυπα για έργα, προϊόντα ή υπηρεσίες. Η εξουσιοδοτημένη χρήση των εμπορικών σημάτων ή λογοτύπων της Microsoft υπόκειται και πρέπει να ακολουθεί τις
Οδηγίες Χρήσης Εμπορικών Σημάτων & Επωνυμίας της Microsoft.
Η χρήση εμπορικών σημάτων ή λογοτύπων της Microsoft σε τροποποιημένες εκδόσεις αυτού του έργου δεν πρέπει να προκαλεί σύγχυση ή να υπονοεί χορηγία από τη Microsoft.
Οποιαδήποτε χρήση εμπορικών σημάτων ή λογοτύπων τρίτων υπόκειται στις πολιτικές αυτών των τρίτων.

Λήψη Βοήθειας

Αν αντιμετωπίζετε δυσκολίες ή έχετε ερωτήσεις σχετικά με την ανάπτυξη εφαρμογών AI, συμμετάσχετε:

Azure AI Foundry Discord

Αν έχετε σχόλια για το προϊόν ή αντιμετωπίζετε σφάλματα κατά την ανάπτυξη, επισκεφθείτε:

Azure AI Foundry Developer Forum


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