README.md

範例

前一個範例展示了如何使用本地的 .NET 專案搭配 stdio 類型，並且如何在容器中本地執行伺服器。這在很多情況下都是不錯的解決方案。不過，有時候讓伺服器遠端運行會更有用，例如在雲端環境中。這時就會用到 http 類型。

看看 04-PracticalImplementation 資料夾中的解決方案，可能會覺得它比之前的範例複雜許多。但實際上並非如此。如果仔細看 src/Calculator 專案，你會發現它大部分的程式碼和前一個範例差不多。唯一的差別是我們使用了不同的函式庫 ModelContextProtocol.AspNetCore 來處理 HTTP 請求，並且將 IsPrime 方法改成 private，這只是為了展示程式碼中也可以有 private 方法。其餘的程式碼都和之前一樣。

其他專案來自 .NET Aspire。將 .NET Aspire 加入解決方案能提升開發和測試時的體驗，也有助於可觀測性。雖然不是執行伺服器的必要條件，但在解決方案中加入它是個好習慣。

本地啟動伺服器

1. 在 VS Code（已安裝 C# DevKit 擴充功能）中，切換到 04-PracticalImplementation/samples/csharp 目錄。

2. 執行以下指令以啟動伺服器：

    dotnet watch run --project ./src/AppHost

3. 當瀏覽器開啟 .NET Aspire 儀表板時，注意 http 的 URL，應該會是類似 http://localhost:5058/ 的網址。

   

使用 MCP Inspector 測試 Streamable HTTP

如果你有安裝 Node.js 22.7.5 以上版本，可以使用 MCP Inspector 來測試你的伺服器。

啟動伺服器後，在終端機執行以下指令：

npx @modelcontextprotocol/inspector http://localhost:5058

• 選擇 Streamable HTTP as the Transport type.
• In the Url field, enter the URL of the server noted earlier, and append /mcp。它應該是 http（而非 https) something like http://localhost:5058/mcp.
• select the Connect button.

A nice thing about the Inspector is that it provide a nice visibility on what is happening.

• Try listing the available tools
• Try some of them, it should works just like before.

Test MCP Server with GitHub Copilot Chat in VS Code

To use the Streamable HTTP transport with GitHub Copilot Chat, change the configuration of the calc-mcp），先前建立的伺服器看起來像這樣：

// .vscode/mcp.json
{
  "servers": {
    "calc-mcp": {
      "type": "http",
      "url": "http://localhost:5058/mcp"
    }
  }
}

做一些測試：

• 詢問「6780 之後的 3 個質數」，注意 Copilot 會使用新工具 NextFivePrimeNumbers 並只回傳前 3 個質數。
• 詢問「111 之後的 7 個質數」，看看結果如何。
• 詢問「John 有 24 顆棒棒糖，要分給他 3 個小孩，每個小孩會有多少顆？」，看看結果如何。

部署伺服器到 Azure

讓我們把伺服器部署到 Azure，讓更多人可以使用。

在終端機中切換到 04-PracticalImplementation/samples/csharp 資料夾，執行以下指令：

azd up

部署完成後，你應該會看到類似這樣的訊息：

複製該 URL，並在 MCP Inspector 以及 GitHub Copilot Chat 中使用。

// .vscode/mcp.json
{
  "servers": {
    "calc-mcp": {
      "type": "http",
      "url": "https://calc-mcp.gentleriver-3977fbcf.australiaeast.azurecontainerapps.io/mcp"
    }
  }
}

接下來呢？

我們嘗試了不同的傳輸類型和測試工具，也將 MCP 伺服器部署到了 Azure。但如果我們的伺服器需要存取私人資源呢？例如資料庫或私有 API？下一章我們將探討如何加強伺服器的安全性。

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