Skip to content

Latest commit

 

History

History
121 lines (97 loc) · 4.76 KB

README.md

File metadata and controls

121 lines (97 loc) · 4.76 KB

Basisrekenmachine MCP Service

Deze service biedt basisrekenkundige bewerkingen via het Model Context Protocol (MCP). Het is ontworpen als een eenvoudig voorbeeld voor beginners die MCP-implementaties leren.

Voor meer informatie, zie C# SDK

Functionaliteiten

Deze rekenmachineservice biedt de volgende mogelijkheden:

  1. Basisrekenkundige bewerkingen:
    • Optellen van twee getallen
    • Aftrekken van een getal van een ander
    • Vermenigvuldigen van twee getallen
    • Delen van een getal door een ander (met controle op deling door nul)

Gebruik van stdio Type

Configuratie

  1. Configureer MCP-servers:

    • Open je werkruimte in VS Code.

    • Maak een .vscode/mcp.json bestand aan in je werkmap om MCP-servers te configureren. Voorbeeldconfiguratie:

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

    • Je wordt gevraagd de root van de GitHub-repository in te voeren, deze kan worden opgehaald met het commando 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> met je Docker Hub-gebruikersnaam): 
    docker build -t <YOUR-DOCKER-USERNAME>/mcp-calculator .
  4. Nadat de image is gebouwd, uploaden we deze naar Docker Hub. Voer het volgende commando uit: 
     docker push <YOUR-DOCKER-USERNAME>/mcp-calculator

## Gebruik de Docker-versie

1. Vervang in het `.vscode/mcp.json` bestand de serverconfiguratie door het volgende:
 ```json
  "mcp-calc": {
    "command": "docker",
    "args": [
      "run",
      "--rm",
      "-i",
      "<YOUR-DOCKER-USERNAME>/mcp-calc"
    ],
    "envFile": "",
    "env": {}
  }

Als je naar de configuratie kijkt, zie je dat het commando 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": { is, en net als eerder kun je de rekenmachineservice vragen wat wiskunde voor je te doen.

Disclaimer:
Dit document is vertaald met behulp van de AI-vertalingsdienst Co-op Translator. Hoewel we streven naar nauwkeurigheid, dient u er rekening mee te houden dat geautomatiseerde vertalingen fouten of onnauwkeurigheden kunnen bevatten. Het originele document in de oorspronkelijke taal moet als de gezaghebbende bron worden beschouwd. Voor cruciale informatie wordt professionele menselijke vertaling aanbevolen. Wij zijn niet aansprakelijk voor eventuele misverstanden of verkeerde interpretaties die voortvloeien uit het gebruik van deze vertaling.