MCP檢查器教程：高效測試與調(diào)試MCP服務(wù)器工具

簡介

MCP檢查器是一個用于測試和調(diào)試MCP服務(wù)器的交互式開發(fā)工具。本文檔深入探討檢查器的功能和能力。

入門指南

安裝與基本用法

檢查器無需安裝，直接通過npx運(yùn)行：

npx @modelcontextprotocol/inspector <command>

npx @modelcontextprotocol/inspector <command> <arg1> <arg2>

然后按照提示操作。

在本地模式下，檢查器默認(rèn)查找 <current-directory>/mcp-server.py。要指定其他目錄或文件，請使用 --directory 和 --file 標(biāo)志。

注意：需要Node.js 18或更高版本。

從NPM或PyPi檢查服務(wù)器

這是從NPM或PyPi啟動服務(wù)器包的常用方法。

NPM

npx -y @modelcontextprotocol/inspector npx <package-name> <args>
## 例如
npx -y @modelcontextprotocol/inspector npx server-postgres postgres://127.0.0.1/testdb

PIPY

npx @modelcontextprotocol/inspector uvx <package-name> <args>
## 例如
npx @modelcontextprotocol/inspector uvx mcp-server-git --repository ~/code/mcp/servers.git

檢查器會自動識別并配置服務(wù)器。

檢查本地開發(fā)的服務(wù)器

對于本地開發(fā)或作為倉庫下載的服務(wù)器，常用的檢查方法是：

TypeScript

npx @modelcontextprotocol/inspector node path/to/server/index.js args...

Python

npx @modelcontextprotocol/inspector \
  uv \
  --directory path/to/server \
  run \
  package-name \
  args...

克隆倉庫并運(yùn)行檢查器：

git clone <repository-url>
cd <repository-directory>
npx @modelcontext/inspector

請仔細(xì)閱讀附帶的README文件，獲取最準(zhǔn)確的說明。

功能概覽

檢查器提供了多種與MCP服務(wù)器交互的功能：

服務(wù)器連接面板

• 允許選擇連接服務(wù)器的傳輸方式。
• 對于本地服務(wù)器，支持自定義命令行參數(shù)和環(huán)境變量。

資源標(biāo)簽頁

• 列出所有可用資源。
• 顯示資源元數(shù)據(jù)（MIME類型、描述等）。
• 允許檢查資源內(nèi)容。
• 支持訂閱測試。

提示標(biāo)簽頁

• 顯示可用提示模板。
• 顯示提示參數(shù)和描述。
• 啟用帶有自定義參數(shù)的提示測試。
• 預(yù)覽生成的消息。

工具標(biāo)簽頁

• 列出可用工具。
• 顯示工具模式和描述。
• 啟用帶有自定義輸入的工具測試。
• 顯示工具執(zhí)行結(jié)果。

通知面板

• 顯示服務(wù)器記錄的所有日志。
• 顯示來自服務(wù)器的通知。

最佳實踐

開發(fā)流程

1. 啟動開發(fā)
   • 啟動檢查器并連接到你的服務(wù)器。
   • 驗證基本連接。
   • 檢查功能協(xié)商。

1. 迭代測試
   • 修改服務(wù)器代碼。
   • 重建服務(wù)器。
   • 重新連接檢查器。
   • 測試受影響的功能。
   • 監(jiān)控消息傳遞。

1. 測試邊緣情況
   • 輸入無效數(shù)據(jù)。
   • 缺少提示參數(shù)。
   • 并發(fā)操作。
   • 驗證錯誤處理和錯誤響應(yīng)。