Files

Weather MCP Server

這是一個使用 Python 實作的天氣工具樣本 MCP Server,提供模擬回應。可作為您自行建立 MCP Server 的骨架。包含以下功能:

  • 天氣工具:根據給定地點提供模擬天氣資訊的工具。
  • 連接至 Agent Builder:允許您將 MCP Server 連接到 Agent Builder 以便測試和除錯。
  • MCP Inspector 中除錯:允許您使用 MCP Inspector 來除錯 MCP Server 的功能。

使用 Weather MCP Server 範本快速開始

前置條件

若要在您的本地開發機器執行 MCP Server,您需要:

環境準備

有兩種方法可設定本專案的環境。您可依照喜好選擇其中一種。

注意:建立虛擬環境後,請重新載入 VSCode 或終端機以確保使用虛擬環境的 Python。

方式 步驟
使用 uv 1. 建立虛擬環境:uv venv
2. 執行 VSCode 指令 "Python: Select Interpreter" 並選擇剛建立的虛擬環境中的 Python
3. 安裝相依套件(含開發相依):uv pip install -r pyproject.toml --extra dev
使用 pip 1. 建立虛擬環境:python -m venv .venv
2. 執行 VSCode 指令 "Python: Select Interpreter" 並選擇剛建立的虛擬環境中的 Python
3. 安裝相依套件(含開發相依):pip install -e .[dev]

環境設定完成後,即可透過 Agent Builder 作為 MCP Client 在您的本地開發機執行伺服器開始使用:

  1. 開啟 VS Code 除錯面板,選擇 Debug in Agent Builder 或按 F5 啟動 MCP Server 除錯。
  2. 使用 Microsoft Foundry Toolkit Agent Builder 以此提示測試伺服器。伺服器會自動連接至 Agent Builder。
  3. 點選 Run 以用提示測試伺服器。

恭喜! 您已成功透過 Agent Builder 作為 MCP Client 在本地開發機執行 Weather MCP Server。 DebugMCP

範本包含內容

資料夾 / 檔案 內容
.vscode VSCode 除錯相關檔案
.aitk Microsoft Foundry Toolkit 配置
src weather mcp server 的原始碼

如何除錯 Weather MCP Server

注意:

  • MCP Inspector 是用於測試和除錯 MCP Server 的視覺化開發者工具。
  • 所有除錯模式均支援斷點,您可以在工具實作程式碼中增加斷點。
除錯模式 說明 除錯步驟
Agent Builder 使用 Microsoft Foundry Toolkit 在 Agent Builder 中除錯 MCP Server。 1. 開啟 VS Code 除錯面板,選擇 Debug in Agent Builder 並按 F5 來啟動 MCP Server 除錯。
2. 使用 Microsoft Foundry Toolkit Agent Builder 依此提示測試伺服器。伺服器會自動連接至 Agent Builder。
3. 點選 Run 以用提示測試伺服器。
MCP Inspector 使用 MCP Inspector 除錯 MCP Server。 1. 安裝 Node.js
2. 設定 Inspectorcd inspector 並執行 npm install
3. 開啟 VS Code 除錯面板,選擇 Debug SSE in Inspector (Edge)Debug SSE in Inspector (Chrome),按 F5 來啟動除錯。
4. MCP Inspector 啟動瀏覽器時,點選 Connect 按鈕以連接本 MCP Server。
5. 接著可用 List Tools 選擇工具,輸入參數,並點 Run Tool 來除錯您的伺服器程式碼。

預設連接埠與自訂設定

除錯模式 連接埠 定義檔 自訂方式 備註
Agent Builder 3001 tasks.json 編輯 launch.jsontasks.json__init__.pymcp.json 更改連接埠。
MCP Inspector 3001 (伺服器)5173 與 3000 (Inspector) tasks.json 編輯 launch.jsontasks.json__init__.pymcp.json 更改連接埠。

回饋

若您對此範本有任何回饋或建議,請在 Microsoft Foundry Toolkit GitHub repository 開啟問題。


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