在建置 MCP 伺服器時,您需要一種方法來測試您的功能,而不必連接到完整的應用程式。Python MCP SDK 包含一個內建的瀏覽器式檢查器,讓您能夠即時偵錯和測試您的伺服器。
啟動檢查器
首先,請確保您的 Python 環境已啟動(請查看您專案的 README 以取得確切指令)。然後使用以下指令執行檢查器:
bash
mcp dev mcp_server.py這會啟動一個開發伺服器,並提供一個本機 URL(通常在連接埠 6277)供您在瀏覽器中存取檢查器。

使用檢查器介面
MCP 檢查器正在積極開發中,因此當您使用時介面可能會有所不同。不過,核心功能保持一致。

點擊「Connect」啟動您的 MCP 伺服器後,您會看到一個導覽列,其中包含以下區段:
- Resources
- Prompts
- Tools
- 其他伺服器功能
測試您的工具
Tools 區段是您花費大部分偵錯時間的地方。點擊「List Tools」以查看您伺服器提供的所有工具。

當您選擇一個工具時,右側面板會顯示其詳細資訊,並提供輸入欄位供測試使用。例如,要測試 read_doc_contents 工具:
- 從清單中選擇該工具
- 輸入文件 ID(例如「deposition.md」)
- 點擊「Run Tool」
- 檢查結果是否成功以及輸出是否符合預期

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

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

開發工作流程
檢查器建立了一個高效的開發循環:
- 對您的 MCP 伺服器程式碼進行變更
- 使用各種輸入測試個別工具
- 驗證工具互動是否如預期運作
- 在不需要完整應用程式設定的情況下偵錯問題
這個以瀏覽器為基礎的測試環境對 MCP 伺服器開發至關重要。它能讓您在與 Claude 或其他應用程式整合之前,及早發現問題並驗證功能,從而節省時間。