Skip to content

Latest commit

 

History

History
120 lines (97 loc) · 7.52 KB

README.md

File metadata and controls

120 lines (97 loc) · 7.52 KB

Βασική Υπηρεσία Υπολογιστή MCP

Αυτή η υπηρεσία παρέχει βασικές λειτουργίες αριθμομηχανής μέσω του Πρωτοκόλλου Πλαισίου Μοντέλου (MCP). Έχει σχεδιαστεί ως ένα απλό παράδειγμα για αρχάριους που μαθαίνουν για υλοποιήσεις MCP.

Για περισσότερες πληροφορίες, δείτε C# SDK

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

Αυτή η υπηρεσία αριθμομηχανής προσφέρει τις εξής δυνατότητες:

  1. Βασικές Αριθμητικές Λειτουργίες:
    • Πρόσθεση δύο αριθμών
    • Αφαίρεση ενός αριθμού από έναν άλλο
    • Πολλαπλασιασμός δύο αριθμών
    • Διαίρεση ενός αριθμού με έναν άλλο (με έλεγχο διαίρεσης με το μηδέν)

Χρήση τύπου stdio

Ρυθμίσεις

  1. Ρύθμιση MCP Servers:

    • Ανοίξτε τον χώρο εργασίας σας στο VS Code.

    • Δημιουργήστε ένα αρχείο .vscode/mcp.json στον φάκελο του χώρου εργασίας σας για να ρυθμίσετε τους MCP servers. Παράδειγμα ρύθμισης:

      {
  "inputs": [
    {
      "type": "promptString",
      "id": "repository-root",
      "description": "The absolute path to the repository root"
    }
  ],
  "servers": {
    "calculator-mcp-dotnet": {
      "type": "stdio",
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "${input:repository-root}/03-GettingStarted/samples/csharp/src/calculator.csproj"
      ]
    }
  }
}

    • Θα σας ζητηθεί να εισάγετε τη ρίζα του αποθετηρίου GitHub, η οποία μπορεί να ληφθεί με την εντολή git rev-parse --show-toplevel.

Χρήση της Υπηρεσίας

Η υπηρεσία εκθέτει τα παρακάτω API endpoints μέσω του πρωτοκόλλου MCP:

  • add(a, b): Προσθέτει δύο αριθμούς
  • subtract(a, b): Αφαιρεί τον δεύτερο αριθμό από τον πρώτο
  • multiply(a, b): Πολλαπλασιάζει δύο αριθμούς
  • divide(a, b): Διαιρεί τον πρώτο αριθμό με τον δεύτερο (με έλεγχο μηδενικής διαίρεσης)
  • isPrime(n): Ελέγχει αν ένας αριθμός είναι πρώτος

Δοκιμή με Github Copilot Chat στο VS Code

  1. Δοκιμάστε να κάνετε ένα αίτημα στην υπηρεσία χρησιμοποιώντας το πρωτόκολλο MCP. Για παράδειγμα, μπορείτε να ζητήσετε:
    • "Πρόσθεσε 5 και 3"
    • "Αφαίρεσε 10 από 4"
    • "Πολλαπλασίασε 6 και 7"
    • "Διαίρεσε 8 με 2"
    • "Είναι το 37854 πρώτος;"
    • "Ποιοι είναι οι 3 πρώτοι αριθμοί πριν και μετά το 4242;"
  2. Για να βεβαιωθείτε ότι χρησιμοποιεί τα εργαλεία, προσθέστε #MyCalculator στο prompt. Για παράδειγμα:
    • "Πρόσθεσε 5 και 3 #MyCalculator"
    • "Αφαίρεσε 10 από 4 #MyCalculator"

Έκδοση με Container

Η προηγούμενη λύση είναι ιδανική όταν έχετε εγκατεστημένο το .NET SDK και όλες οι εξαρτήσεις είναι στη θέση τους. Ωστόσο, αν θέλετε να μοιραστείτε τη λύση ή να την τρέξετε σε διαφορετικό περιβάλλον, μπορείτε να χρησιμοποιήσετε την έκδοση με container.

  1. Ξεκινήστε το Docker και βεβαιωθείτε ότι τρέχει.
  2. Από ένα τερματικό, μεταβείτε στον φάκελο 03-GettingStarted\samples\csharp\src
  3. Για να δημιουργήσετε την εικόνα Docker για την υπηρεσία αριθμομηχανής, εκτελέστε την παρακάτω εντολή (αντικαταστήστε το <YOUR-DOCKER-USERNAME> με το όνομα χρήστη σας στο Docker Hub): 
    docker build -t <YOUR-DOCKER-USERNAME>/mcp-calculator .
  4. Αφού δημιουργηθεί η εικόνα, ανεβάστε την στο Docker Hub. Εκτελέστε την παρακάτω εντολή: 
     docker push <YOUR-DOCKER-USERNAME>/mcp-calculator

## Χρήση της Dockerized Έκδοσης

1. Στο αρχείο `.vscode/mcp.json`, αντικαταστήστε τη ρύθμιση του server με την παρακάτω:
 ```json
  "mcp-calc": {
    "command": "docker",
    "args": [
      "run",
      "--rm",
      "-i",
      "<YOUR-DOCKER-USERNAME>/mcp-calc"
    ],
    "envFile": "",
    "env": {}
  }

Κοιτάζοντας τη ρύθμιση, μπορείτε να δείτε ότι η εντολή είναι docker και τα ορίσματα είναι run --rm -i <YOUR-DOCKER-USERNAME>/mcp-calc. Η σημαία --rm εξασφαλίζει ότι το container αφαιρείται μετά τη διακοπή του, και η σημαία -i επιτρέπει την αλληλεπίδραση με την τυπική είσοδο του container. Το τελευταίο όρισμα είναι το όνομα της εικόνας που μόλις δημιουργήσαμε και ανεβάσαμε στο Docker Hub.

Δοκιμή της Dockerized Έκδοσης

Ξεκινήστε τον MCP Server πατώντας το μικρό κουμπί Start πάνω από το "mcp-calc": {, και όπως πριν, μπορείτε να ζητήσετε από την υπηρεσία αριθμομηχανής να κάνει κάποιους υπολογισμούς για εσάς.

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