載入中
載入中

在建構 MCP 伺服器時,您需要一種方法來測試功能,而無需連接到完整的應用程式。Python MCP SDK 內建了一個基於瀏覽器的檢查器,讓您能夠即時偵錯和測試您的伺服器。

啟動檢查器

首先,請確保您的 Python 環境已啟用(請查看您專案的 README 以取得確切指令)。然後使用以下指令執行檢查器:

bash
mcp dev mcp_server.py

這會在連接埠 6277 上啟動一個開發伺服器,並提供一個本機 URL 供您在瀏覽器中開啟。檢查器介面將會載入,顯示 MCP Inspector 儀表板。

連接前的 MCP Inspector 儀表板:傳輸類型 STDIO、指令 uv、一個「Connect」按鈕,以及狀態「Disconnected」。

關於介面的重要說明

這裡的圖片和影片展示的是檢查器的第 1 版,但 mcp dev 現在會啟動第 2 版,這需要 Node.js 22.19 或更高版本。在第 2 版中,您需要在伺服器卡片上開啟開關,而不是點擊「Connect」;Tools 分頁會列出您的工具,而不需要「List Tools」按鈕;「Run Tool」則改稱為「Execute Tool」。

連接並測試工具

點擊左側的「Connect」按鈕以啟動您的 MCP 伺服器。連接後,您會看到一個導覽列,其中包含 Resources、Prompts、Tools 及其他功能的區段。

連接後的 MCP inspector,顯示 Connected 狀態,以及 Resources、Prompts、Tools、Ping、Sampling 和 Roots 分頁。

要測試您的工具:

  • 導覽至 Tools 區段
  • 點擊「List Tools」以查看所有可用的工具
  • 選擇一個工具以開啟其測試介面
  • 填入所需的參數
  • 點擊「Run Tool」以執行並查看結果

MCP Inspector 的 Tools 分頁列出工具 read_doc_contents 和 edit_document,每個工具都附有簡短說明。

測試文件操作

舉例來說,要測試文件讀取工具,您會輸入一個文件 ID(例如「deposition.md」)並執行該工具。檢查器會顯示結果,包括任何回傳的內容或成功訊息。

MCP Inspector 對「deposition.md」執行 read_doc_contents 的結果:「Success」以及以「A report deposition covers」開頭的文字。

您可以串連多個操作以驗證功能。例如,在透過替換文字編輯文件之後,您可以立即再次執行讀取工具,以確認變更已正確套用。

開發工作流程

檢查器能建立一個高效率的開發循環:

  • 對您的 MCP 伺服器程式碼進行變更
  • 透過檢查器測試個別工具
  • 無需完整的應用程式設定即可驗證結果
  • 獨立偵錯問題

當您建構更複雜的 MCP 伺服器時,這個工具會變得不可或缺。它省去了為了測試基本功能而必須將伺服器接上 Claude 或其他應用程式的需求,使開發過程更快速、更專注。