Skip to content

Latest commit

 

History

History
121 lines (97 loc) · 4.81 KB

README.md

File metadata and controls

121 lines (97 loc) · 4.81 KB

Servizio Calcolatrice Base MCP

Questo servizio offre operazioni di calcolatrice di base tramite il Model Context Protocol (MCP). È progettato come esempio semplice per chi si avvicina alle implementazioni MCP.

Per maggiori informazioni, vedi C# SDK

Funzionalità

Questo servizio calcolatrice offre le seguenti capacità:

  1. Operazioni Aritmetiche di Base:
    • Somma di due numeri
    • Sottrazione di un numero da un altro
    • Moltiplicazione di due numeri
    • Divisione di un numero per un altro (con controllo della divisione per zero)

Uso di stdio Type

Configurazione

  1. Configura i Server MCP:

    • Apri il tuo workspace in VS Code.

    • Crea un file .vscode/mcp.json nella cartella del workspace per configurare i server MCP. Esempio di configurazione:

      {
  "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"
      ]
    }
  }
}

    • Ti verrà chiesto di inserire la root del repository GitHub, che può essere ottenuta con il comando git rev-parse --show-toplevel.

Using the Service

The service exposes the following API endpoints through the MCP protocol:

  • add(a, b): Add two numbers together
  • subtract(a, b): Subtract the second number from the first
  • multiply(a, b): Multiply two numbers
  • divide(a, b): Divide the first number by the second (with zero check)
  • isPrime(n): Check if a number is prime

Test with Github Copilot Chat in VS Code

  1. Try making a request to the service using the MCP protocol. For example, you can ask:
    • "Add 5 and 3"
    • "Subtract 10 from 4"
    • "Multiply 6 and 7"
    • "Divide 8 by 2"
    • "Does 37854 prime?"
    • "What are the 3 prime numbers before after 4242?"
  2. To make sure it's using the tools add #MyCalculator to the prompt. For example:
    • "Add 5 and 3 #MyCalculator"
    • "Subtract 10 from 4 #MyCalculator

Containerized Version

The previous soultion is great when you have the .NET SDK installed, and all the dependencies are in place. However, if you would like to share the solution or run it in a different environment, you can use the containerized version.

  1. Start Docker and make sure it's running.
  2. From a terminal, navigate in the folder 03-GettingStarted\samples\csharp\src
  3. To build the Docker image for the calculator service, execute the following command (replace <YOUR-DOCKER-USERNAME> con il tuo nome utente Docker Hub): 
    docker build -t <YOUR-DOCKER-USERNAME>/mcp-calculator .
  4. Dopo che l’immagine è stata costruita, carichiamola su Docker Hub. Esegui il seguente comando: 
     docker push <YOUR-DOCKER-USERNAME>/mcp-calculator

## Usa la Versione Dockerizzata

1. Nel file `.vscode/mcp.json`, sostituisci la configurazione del server con la seguente:
 ```json
  "mcp-calc": {
    "command": "docker",
    "args": [
      "run",
      "--rm",
      "-i",
      "<YOUR-DOCKER-USERNAME>/mcp-calc"
    ],
    "envFile": "",
    "env": {}
  }

Guardando la configurazione, puoi vedere che il comando è docker and the args are run --rm -i <YOUR-DOCKER-USERNAME>/mcp-calc. The --rm flag ensures that the container is removed after it stops, and the -i flag allows you to interact with the container's standard input. The last argument is the name of the image we just built and pushed to Docker Hub.

Test the Dockerized Version

Start the MCP Server by clicking the little Start button above "mcp-calc": {, e proprio come prima puoi chiedere al servizio calcolatrice di fare qualche operazione matematica per te.

Disclaimer:
Questo documento è stato tradotto utilizzando il servizio di traduzione automatica Co-op Translator. Pur impegnandoci per l’accuratezza, si prega di notare che le traduzioni automatiche possono contenere errori o imprecisioni. Il documento originale nella sua lingua nativa deve essere considerato la fonte autorevole. Per informazioni critiche, si raccomanda una traduzione professionale effettuata da un traduttore umano. Non ci assumiamo alcuna responsabilità per eventuali incomprensioni o interpretazioni errate derivanti dall’uso di questa traduzione.