Skip to content

complete_examples.md

Latest commit

 

History

History
162 lines (120 loc) · 9.41 KB

complete_examples.md

File metadata and controls

162 lines (120 loc) · 9.41 KB

Πλήρη Παραδείγματα Πελατών MCP

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

Διαθέσιμοι Πελάτες

1. Πελάτης Java (client_example_java.java)

  • Μεταφορά: SSE (Server-Sent Events) μέσω HTTP
  • Διακομιστής Στόχος: http://localhost:8080
  • Χαρακτηριστικά:
    • Δημιουργία σύνδεσης και ping
    • Λίστα εργαλείων
    • Λειτουργίες αριθμομηχανής (πρόσθεση, αφαίρεση, πολλαπλασιασμός, διαίρεση, βοήθεια)
    • Διαχείριση σφαλμάτων και εξαγωγή αποτελεσμάτων

Για εκτέλεση:

# Ensure your MCP server is running on localhost:8080
javac client_example_java.java
java client_example_java

2. Πελάτης C# (client_example_csharp.cs)

  • Μεταφορά: Stdio (Τυπική Είσοδος/Έξοδος)
  • Διακομιστής Στόχος: Τοπικός διακομιστής MCP .NET μέσω dotnet run
  • Χαρακτηριστικά:
    • Αυτόματη εκκίνηση διακομιστή μέσω μεταφοράς stdio
    • Λίστα εργαλείων και πόρων
    • Λειτουργίες αριθμομηχανής
    • Ανάλυση αποτελεσμάτων JSON
    • Εκτενής διαχείριση σφαλμάτων

Για εκτέλεση:

dotnet run

3. Πελάτης TypeScript (client_example_typescript.ts)

  • Μεταφορά: Stdio (Τυπική Είσοδος/Έξοδος)
  • Διακομιστής Στόχος: Τοπικός διακομιστής MCP Node.js
  • Χαρακτηριστικά:
    • Πλήρης υποστήριξη πρωτοκόλλου MCP
    • Λειτουργίες εργαλείων, πόρων και προτροπών
    • Λειτουργίες αριθμομηχανής
    • Ανάγνωση περιεχομένου πόρων και εκτέλεση προτροπών
    • Ισχυρή διαχείριση σφαλμάτων

Για εκτέλεση:

# First compile TypeScript (if needed)
npm run build

# Then run the client
npm run client
# or
node client_example_typescript.js

4. Πελάτης Python (client_example_python.py)

  • Μεταφορά: Stdio (Τυπική Είσοδος/Έξοδος)
  • Διακομιστής Στόχος: Τοπικός διακομιστής MCP Python
  • Χαρακτηριστικά:
    • Πρότυπο async/await για λειτουργίες
    • Ανακάλυψη εργαλείων και πόρων
    • Δοκιμή λειτουργιών αριθμομηχανής
    • Ανάγνωση περιεχομένου πόρων
    • Οργάνωση βασισμένη σε κλάσεις

Για εκτέλεση:

python client_example_python.py

Κοινά Χαρακτηριστικά σε Όλους τους Πελάτες

Κάθε υλοποίηση πελάτη επιδεικνύει:

  1. Διαχείριση Σύνδεσης

    • Δημιουργία σύνδεσης με τον διακομιστή MCP
    • Διαχείριση σφαλμάτων σύνδεσης
    • Σωστός καθαρισμός και διαχείριση πόρων

  2. Ανακάλυψη Διακομιστή

    • Λίστα διαθέσιμων εργαλείων
    • Λίστα διαθέσιμων πόρων (όπου υποστηρίζεται)
    • Λίστα διαθέσιμων προτροπών (όπου υποστηρίζεται)

  3. Εκτέλεση Εργαλείων

    • Βασικές λειτουργίες αριθμομηχανής (πρόσθεση, αφαίρεση, πολλαπλασιασμός, διαίρεση)
    • Εντολή βοήθειας για πληροφορίες διακομιστή
    • Σωστή μεταβίβαση επιχειρημάτων και διαχείριση αποτελεσμάτων

  4. Διαχείριση Σφαλμάτων

    • Σφάλματα σύνδεσης
    • Σφάλματα εκτέλεσης εργαλείων
    • Ομαλή αποτυχία και ανατροφοδότηση προς τον χρήστη

  5. Επεξεργασία Αποτελεσμάτων

    • Εξαγωγή περιεχομένου κειμένου από απαντήσεις
    • Μορφοποίηση εξόδου για αναγνωσιμότητα
    • Διαχείριση διαφορετικών μορφών απαντήσεων

Προαπαιτούμενα

Πριν εκτελέσετε αυτούς τους πελάτες, βεβαιωθείτε ότι έχετε:

  1. Τον αντίστοιχο διακομιστή MCP σε λειτουργία (από ../01-first-server/)
  2. Εγκατεστημένες τις απαιτούμενες εξαρτήσεις για τη γλώσσα που επιλέξατε
  3. Κατάλληλη συνδεσιμότητα δικτύου (για μεταφορές μέσω HTTP)

Βασικές Διαφορές Μεταξύ Υλοποιήσεων

Γλώσσα Μεταφορά Εκκίνηση Διακομιστή Μοντέλο Async Κύριες Βιβλιοθήκες
Java SSE/HTTP Εξωτερική Sync WebFlux, MCP SDK
C# Stdio Αυτόματη Async/Await .NET MCP SDK
TypeScript Stdio Αυτόματη Async/Await Node MCP SDK
Python Stdio Αυτόματη AsyncIO Python MCP SDK
Rust Stdio Αυτόματη Async/Await Rust MCP SDK, Tokio

Επόμενα Βήματα

Αφού εξερευνήσετε αυτά τα παραδείγματα πελατών:

  1. Τροποποιήστε τους πελάτες για να προσθέσετε νέες λειτουργίες ή ενέργειες
  2. Δημιουργήστε τον δικό σας διακομιστή και δοκιμάστε τον με αυτούς τους πελάτες
  3. Πειραματιστείτε με διαφορετικές μεταφορές (SSE έναντι Stdio)
  4. Δημιουργήστε μια πιο σύνθετη εφαρμογή που ενσωματώνει λειτουργικότητα MCP

Επίλυση Προβλημάτων

Συνήθη Προβλήματα

  1. Η σύνδεση απορρίφθηκε: Βεβαιωθείτε ότι ο διακομιστής MCP λειτουργεί στη σωστή θύρα/διαδρομή
  2. Το module δεν βρέθηκε: Εγκαταστήστε το απαιτούμενο MCP SDK για τη γλώσσα σας
  3. Άρνηση πρόσβασης: Ελέγξτε τα δικαιώματα αρχείων για τη μεταφορά stdio
  4. Το εργαλείο δεν βρέθηκε: Επαληθεύστε ότι ο διακομιστής υλοποιεί τα αναμενόμενα εργαλεία

Συμβουλές για Εντοπισμό Σφαλμάτων

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

Σχετική Τεκμηρίωση

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