Skip to content

Latest commit

 

History

History
121 lines (97 loc) · 4.43 KB

README.md

File metadata and controls

121 lines (97 loc) · 4.43 KB

基本計算機 MCP 服務

此服務透過 Model Context Protocol (MCP) 提供基本的計算機運算功能。它設計為一個簡單範例，適合初學者了解 MCP 的實作方式。

欲了解更多資訊，請參考 C# SDK

功能特色

此計算機服務提供以下功能：

  1. 基本算術運算：
    • 兩數相加
    • 一數減去另一數
    • 兩數相乘
    • 一數除以另一數（含除以零的檢查）

使用 stdio 類型

設定說明

  1. 設定 MCP 伺服器：

    • 在 VS Code 中開啟您的工作區。

    • 在工作區資料夾中建立 .vscode/mcp.json 檔案來設定 MCP 伺服器。範例設定如下：

      {
  "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 取得`.

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>，將 <YOUR-DOCKER-USERNAME> 替換成您的 Docker Hub 使用者名稱： 
    docker build -t <YOUR-DOCKER-USERNAME>/mcp-calculator .
  4. 映像檔建立完成後，接著將其上傳到 Docker Hub。請執行以下指令： 
     docker push <YOUR-DOCKER-USERNAME>/mcp-calculator

## 使用 Docker 版本

1. 在 `.vscode/mcp.json` 檔案中，將伺服器設定替換為以下內容：
 ```json
  "mcp-calc": {
    "command": "docker",
    "args": [
      "run",
      "--rm",
      "-i",
      "<YOUR-DOCKER-USERNAME>/mcp-calc"
    ],
    "envFile": "",
    "env": {}
  }

從設定內容可以看到，指令為 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": {，和之前一樣，您可以請計算機服務幫您進行數學運算。

免責聲明：
本文件係使用 AI 翻譯服務 Co-op Translator 進行翻譯。雖然我們致力於確保準確性，但請注意，自動翻譯可能包含錯誤或不準確之處。原始文件的母語版本應視為權威來源。對於重要資訊，建議採用專業人工翻譯。我們不對因使用本翻譯所引起的任何誤解或誤譯承擔責任。