Skip to content

Latest commit

 

History

History
111 lines (88 loc) · 8.12 KB

README.md

File metadata and controls

111 lines (88 loc) · 8.12 KB

Basic Calculator MCP Service

ਇਹ ਸੇਵਾ Model Context Protocol (MCP) ਰਾਹੀਂ ਬੁਨਿਆਦੀ ਕੈਲਕੂਲੇਟਰ ਕਾਰਜ ਪ੍ਰਦਾਨ ਕਰਦੀ ਹੈ। ਇਹ MCP ਇੰਪਲੀਮੈਂਟੇਸ਼ਨਾਂ ਬਾਰੇ ਸਿੱਖ ਰਹੇ ਸ਼ੁਰੂਆਤੀ ਵਿਅਕਤੀਆਂ ਲਈ ਇੱਕ ਸਧਾਰਣ ਉਦਾਹਰਨ ਵਜੋਂ ਤਿਆਰ ਕੀਤੀ ਗਈ ਹੈ।

ਵਧੇਰੇ ਜਾਣਕਾਰੀ ਲਈ, ਵੇਖੋ C# SDK

ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ

ਇਹ ਕੈਲਕੂਲੇਟਰ ਸੇਵਾ ਹੇਠ ਲਿਖੀਆਂ ਸਮਰੱਥਾਵਾਂ ਦਿੰਦੀ ਹੈ:

  1. ਮੂਲ ਅੰਕਗਣਿਤੀ ਕਾਰਜ:
    • ਦੋ ਨੰਬਰਾਂ ਦਾ ਜੋੜ
    • ਇੱਕ ਨੰਬਰ ਵਿੱਚੋਂ ਦੂਜੇ ਦਾ ਘਟਾਅ
    • ਦੋ ਨੰਬਰਾਂ ਦਾ ਗੁਣਾ
    • ਇੱਕ ਨੰਬਰ ਨੂੰ ਦੂਜੇ ਨਾਲ ਭਾਗ ਦੇਣਾ (ਜਿੱਥੇ ਜ਼ੀਰੋ ਨਾਲ ਭਾਗ ਦੇਣ ਦੀ ਜਾਂਚ ਕੀਤੀ ਜਾਂਦੀ ਹੈ)

stdio ਕਿਸਮ ਦੀ ਵਰਤੋਂ

ਸੰਰਚਨਾ

  1. MCP ਸਰਵਰਾਂ ਦੀ ਸੰਰਚਨਾ ਕਰੋ:

    • VS Code ਵਿੱਚ ਆਪਣਾ ਵਰਕਸਪੇਸ ਖੋਲ੍ਹੋ।

    • MCP ਸਰਵਰਾਂ ਦੀ ਸੰਰਚਨਾ ਲਈ ਆਪਣੇ ਵਰਕਸਪੇਸ ਫੋਲਡਰ ਵਿੱਚ .vscode/mcp.json ਫਾਈਲ ਬਣਾਓ। ਉਦਾਹਰਨ ਵਜੋਂ ਸੰਰਚਨਾ:

      {
  "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 ਰਾਹੀਂ ਪ੍ਰਾਪਤ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ।

ਸੇਵਾ ਦੀ ਵਰਤੋਂ

ਸੇਵਾ MCP ਪ੍ਰੋਟੋਕੋਲ ਰਾਹੀਂ ਹੇਠ ਲਿਖੇ API ਐਂਡਪੌਇੰਟ ਪ੍ਰਦਾਨ ਕਰਦੀ ਹੈ:

  • add(a, b): ਦੋ ਨੰਬਰਾਂ ਨੂੰ ਜੋੜੋ
  • subtract(a, b): ਪਹਿਲੇ ਨੰਬਰ ਵਿੱਚੋਂ ਦੂਜਾ ਘਟਾਓ
  • multiply(a, b): ਦੋ ਨੰਬਰਾਂ ਦਾ ਗੁਣਾ ਕਰੋ
  • divide(a, b): ਪਹਿਲੇ ਨੰਬਰ ਨੂੰ ਦੂਜੇ ਨਾਲ ਭਾਗ ਦਿਓ (ਜ਼ੀਰੋ ਚੈੱਕ ਸਮੇਤ)
  • isPrime(n): ਜਾਂਚੋ ਕਿ ਨੰਬਰ ਪ੍ਰਾਈਮ ਹੈ ਜਾਂ ਨਹੀਂ

VS Code ਵਿੱਚ Github Copilot Chat ਨਾਲ ਟੈਸਟ ਕਰੋ

  1. MCP ਪ੍ਰੋਟੋਕੋਲ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਸੇਵਾ ਨੂੰ ਬੇਨਤੀ ਭੇਜਣ ਦੀ ਕੋਸ਼ਿਸ਼ ਕਰੋ। ਉਦਾਹਰਨ ਵਜੋਂ, ਤੁਸੀਂ ਪੁੱਛ ਸਕਦੇ ਹੋ:
    • "5 ਅਤੇ 3 ਜੋੜੋ"
    • "4 ਵਿੱਚੋਂ 10 ਘਟਾਓ"
    • "6 ਅਤੇ 7 ਦਾ ਗੁਣਾ ਕਰੋ"
    • "8 ਨੂੰ 2 ਨਾਲ ਭਾਗ ਦਿਓ"
    • "ਕੀ 37854 ਪ੍ਰਾਈਮ ਹੈ?"
    • "4242 ਤੋਂ ਪਹਿਲਾਂ ਅਤੇ ਬਾਅਦ ਦੇ 3 ਪ੍ਰਾਈਮ ਨੰਬਰ ਕਿਹੜੇ ਹਨ?"
  2. ਇਹ ਯਕੀਨੀ ਬਣਾਉਣ ਲਈ ਕਿ ਇਹ ਟੂਲਜ਼ ਦੀ ਵਰਤੋਂ ਕਰ ਰਿਹਾ ਹੈ, ਪ੍ਰਾਂਪਟ ਵਿੱਚ #MyCalculator ਸ਼ਾਮਲ ਕਰੋ। ਉਦਾਹਰਨ ਵਜੋਂ:
    • "5 ਅਤੇ 3 ਜੋੜੋ #MyCalculator"
    • "4 ਵਿੱਚੋਂ 10 ਘਟਾਓ #MyCalculator"

ਕੰਟੇਨਰਾਈਜ਼ਡ ਵਰਜਨ

ਪਿਛਲਾ ਹੱਲ ਵਧੀਆ ਹੈ ਜਦੋਂ ਤੁਹਾਡੇ ਕੋਲ .NET SDK ਇੰਸਟਾਲ ਹੈ ਅਤੇ ਸਾਰੀਆਂ ਡਿਪੈਂਡੈਂਸੀਜ਼ ਮੌਜੂਦ ਹਨ। ਪਰ ਜੇ ਤੁਸੀਂ ਹੱਲ ਸਾਂਝਾ ਕਰਨਾ ਚਾਹੁੰਦੇ ਹੋ ਜਾਂ ਕਿਸੇ ਹੋਰ ਵਾਤਾਵਰਣ ਵਿੱਚ ਚਲਾਉਣਾ ਚਾਹੁੰਦੇ ਹੋ, ਤਾਂ ਤੁਸੀਂ ਕੰਟੇਨਰਾਈਜ਼ਡ ਵਰਜਨ ਦੀ ਵਰਤੋਂ ਕਰ ਸਕਦੇ ਹੋ।

  1. Docker ਸ਼ੁਰੂ ਕਰੋ ਅਤੇ ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਇਹ ਚੱਲ ਰਿਹਾ ਹੈ।
  2. ਟਰਮੀਨਲ ਤੋਂ 03-GettingStarted\samples\csharp\src ਫੋਲਡਰ ਵਿੱਚ ਜਾਓ
  3. ਕੈਲਕੂਲੇਟਰ ਸੇਵਾ ਲਈ Docker ਇਮੇਜ ਬਣਾਉਣ ਲਈ ਹੇਠ ਲਿਖੀ ਕਮਾਂਡ ਚਲਾਓ (ਆਪਣਾ Docker Hub ਯੂਜ਼ਰਨੇਮ <YOUR-DOCKER-USERNAME> ਨਾਲ ਬਦਲੋ): 
    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 ਹੈ ਅਤੇ args ਹਨ run --rm -i <YOUR-DOCKER-USERNAME>/mcp-calc। --rm ਫਲੈਗ ਇਹ ਯਕੀਨੀ ਬਣਾਉਂਦਾ ਹੈ ਕਿ ਕੰਟੇਨਰ ਰੁਕਣ ਤੋਂ ਬਾਅਦ ਹਟਾ ਦਿੱਤਾ ਜਾਵੇਗਾ, ਅਤੇ -i ਫਲੈਗ ਤੁਹਾਨੂੰ ਕੰਟੇਨਰ ਦੇ ਸਟੈਂਡਰਡ ਇਨਪੁੱਟ ਨਾਲ ਇੰਟਰਐਕਟ ਕਰਨ ਦੀ ਆਗਿਆ ਦਿੰਦਾ ਹੈ। ਆਖਰੀ ਆਰਗੁਮੈਂਟ ਉਸ ਇਮੇਜ ਦਾ ਨਾਮ ਹੈ ਜੋ ਅਸੀਂ ਹੁਣੇ ਬਣਾਇਆ ਅਤੇ Docker Hub 'ਤੇ ਅਪਲੋਡ ਕੀਤਾ।

Docker ਵਰਜਨ ਦੀ ਟੈਸਟਿੰਗ

"mcp-calc": { ਦੇ ਉੱਪਰ ਛੋਟੇ Start ਬਟਨ 'ਤੇ ਕਲਿੱਕ ਕਰਕੇ MCP ਸਰਵਰ ਸ਼ੁਰੂ ਕਰੋ, ਅਤੇ ਪਹਿਲਾਂ ਵਾਂਗ ਹੀ ਤੁਸੀਂ ਕੈਲਕੂਲੇਟਰ ਸੇਵਾ ਨੂੰ ਕੁਝ ਗਣਿਤ ਕਰਨ ਲਈ ਕਹਿ ਸਕਦੇ ਹੋ।

ਅਸਵੀਕਾਰੋਪਣ:
ਇਹ ਦਸਤਾਵੇਜ਼ AI ਅਨੁਵਾਦ ਸੇਵਾ Co-op Translator ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਅਨੁਵਾਦਿਤ ਕੀਤਾ ਗਿਆ ਹੈ। ਜਦੋਂ ਕਿ ਅਸੀਂ ਸਹੀਤਾ ਲਈ ਕੋਸ਼ਿਸ਼ ਕਰਦੇ ਹਾਂ, ਕਿਰਪਾ ਕਰਕੇ ਧਿਆਨ ਰੱਖੋ ਕਿ ਸਵੈਚਾਲਿਤ ਅਨੁਵਾਦਾਂ ਵਿੱਚ ਗਲਤੀਆਂ ਜਾਂ ਅਸਮਰਥਤਾਵਾਂ ਹੋ ਸਕਦੀਆਂ ਹਨ। ਮੂਲ ਦਸਤਾਵੇਜ਼ ਆਪਣੀ ਮੂਲ ਭਾਸ਼ਾ ਵਿੱਚ ਪ੍ਰਮਾਣਿਕ ਸਰੋਤ ਮੰਨਿਆ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਮਹੱਤਵਪੂਰਨ ਜਾਣਕਾਰੀ ਲਈ, ਪੇਸ਼ੇਵਰ ਮਨੁੱਖੀ ਅਨੁਵਾਦ ਦੀ ਸਿਫਾਰਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। ਅਸੀਂ ਇਸ ਅਨੁਵਾਦ ਦੀ ਵਰਤੋਂ ਤੋਂ ਉਤਪੰਨ ਕਿਸੇ ਵੀ ਗਲਤਫਹਿਮੀ ਜਾਂ ਗਲਤ ਵਿਆਖਿਆ ਲਈ ਜ਼ਿੰਮੇਵਾਰ ਨਹੀਂ ਹਾਂ।