載入中
載入中

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

啟動檢查器

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

bash
mcp dev mcp_server.py

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

終端機輸出:代理伺服器正在 6277 連接埠監聽,MCP Inspector 已在 http://127.0.0.1:6274 啟動並運作。

使用檢查器介面

這裡的圖片和影片顯示的是檢查器的第 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」即可看到您的伺服器提供的所有工具。

MCP Inspector 的 Tools 分頁在點擊「List Tools」後,列出 read_doc_contents 和 edit_document,並附上各自的說明。

當您選取一個工具時,右側面板會顯示其詳細資訊,並提供用於測試的輸入欄位。例如,若要測試 read_doc_contents 工具:

  1. 從清單中選取該工具
  2. 輸入文件 ID(例如「deposition.md」)
  3. 點擊「Run Tool」
  4. 檢查結果是否成功以及是否為預期輸出

MCP Inspector 的 Tools 分頁列出 read_doc_contents 和 edit_document 工具,並有一個 doc_id 欄位及 Run Tool 按鈕。

測試工具之間的互動

您可以依序測試多個工具,以驗證它們是否能正確地協同運作。舉例來說,在使用 edit_document 工具修改內容之後:

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

再次以相同的文件 ID 執行 read_doc_contents 工具,以確認您的變更已套用:

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

開發工作流程

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

  • 對您的 MCP 伺服器程式碼進行變更
  • 使用各種輸入測試個別工具
  • 驗證工具之間的互動是否符合預期
  • 無需完整的應用程式設定即可偵錯問題

這種以瀏覽器為基礎的測試環境,對於 MCP 伺服器開發而言至關重要。它能讓您及早發現問題,並在與 Claude 或其他應用程式整合之前驗證功能,從而節省時間。