載入中
載入中

在建置 MCP 伺服器時,您需要一種方法來測試您的功能,而無需連接到完整的應用程式。Python MCP SDK 包含一個內建的、以瀏覽器為基礎的檢查器,讓您可以即時除錯和測試您的伺服器。

啟動檢查器

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

bash
mcp dev mcp_server.py

這會啟動一個開發伺服器,並提供一個本機 URL(通常在連接埠 6277 上),讓您可以在瀏覽器中存取檢查器。

使用檢查器介面

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

連接前的 MCP 檢查器,使用標準輸入/輸出傳輸,顯示「Connect」按鈕與狀態「Disconnected」。

當您第一次開啟檢查器時,您會在左側看到一個「Connect」按鈕。點擊此按鈕以啟動您的 MCP 伺服器並載入您的工具。

測試您的工具

連接後,請尋找導覽列,其中包含 Resources、Prompts 和 Tools 等區段。點擊 Tools 區段即可看到您可用的工具。

點擊「List Tools」以查看您伺服器提供的所有工具。當您選取特定工具時,右側面板會更新,顯示一個表單,讓您可以測試該工具。

執行工具測試

例如,要測試一個文件讀取工具:

  • 選取 read_doc_contents 工具
  • 輸入一個文件 ID(例如「deposition.md」)
  • 點擊「Run Tool」

檢查器會執行您的工具並顯示結果,包括成功狀態以及任何回傳的資料。

MCP 檢查器:對「deposition.md」執行 read_doc_contents,顯示 Tool Result Success,文字開頭為「A report deposition covers」。

測試文件編輯

您也可以測試更複雜的工具,例如文件編輯:

  • 切換到 edit_document 工具
  • 填入文件 ID、要取代的舊文字,以及新文字
  • 執行工具以查看是否成功
  • 再次使用讀取工具以驗證變更是否已套用

MCP Inspector 的 edit_document 表單,doc_id 為 deposition.md,old_str 為「This」,new_str 為「A report」,並顯示 Tool Result: Success。

開發工作流程

檢查器會在左側顯示您工具呼叫的歷史紀錄,讓您可以輕鬆追蹤已測試過的內容,並重複先前的操作。這創造了一個高效的開發循環,讓您可以:

  • 對您的伺服器程式碼進行變更
  • 重新啟動檢查器
  • 立即測試您的工具
  • 驗證結果

隨著您建置更複雜的 MCP 伺服器,這個檢查器工具會變得不可或缺。它消除了為了測試基本功能而必須將您的伺服器連接到完整應用程式的需求,讓開發過程更快速、更可靠。