MCP Inspector 能檢查 MCP 伺服器,不必先把它接進 AI 對話。這次測試 2.15.0 的 CLI:列出工具、讀回已知檔案,再對目錄外檔案呼叫,取得工具錯誤與 exit code 5。測的是 CLI 和 stdio,沒有測 Web UI、OAuth 或真實帳戶。
想用自己能控制的範例練習,可從 FastMCP 的最小伺服器開始;文件查詢工具則可比較 Context7 的查詢流程。
用同一份合成資料測成功與失敗
準備 project/README.md,內容包含 Dispatch NOTE-31 leaves at 08:30.。在目錄外另放 outside.txt。Filesystem 2.3.0 只允許 project 的絕對路徑。這讓成功和拒絕案例都能知道預期結果,不必碰個人資料。
先列清單,再呼叫指定工具
使用 Node.js 24 與固定版本。下列指令的 -- 用來分隔 Inspector 參數與伺服器命令;--protocol-era legacy 明確選用本次已測的舊協定連線。--format json 的外層包含 result,腳本應照實際結構取值,不要沿用別版的假設。
以下為 POSIX shell 指令;本次在 Linux 容器測試,未測 Windows shell。
npm install --ignore-scripts --save-exact @modelcontextprotocol/inspector@2.15.0 @modelcontextprotocol/server-filesystem@2.3.0
npx --no-install mcp-inspector --cli --format json --protocol-era legacy --method tools/list -- node node_modules/@modelcontextprotocol/server-filesystem/dist/index.js /absolute/path/to/project
npx --no-install mcp-inspector --cli --format json --protocol-era legacy --method tools/call --tool-name read_text_file --tool-args-json '{"path":"/absolute/path/to/project/README.md"}' -- node node_modules/@modelcontextprotocol/server-filesystem/dist/index.js /absolute/path/to/project
工具錯誤也要看程序代碼
tools/list 回傳 read_text_file,合法 tools/call 讀回 README 句子且 exit 0。把 path 改成 /tmp/outside.txt 時,stdout 的 result.isError=true,程序 exit 5,stderr 另有 tool_is_error。自動化不能只檢查 JSON 能否解析;也要區分工具回報失敗與連線或參數錯誤。
這個測試不包含 UI 與驗證流程
Web UI、TUI、HTTP、OAuth 與 mcpdo 依官方文件 v2.15.0 整理,未本地實測。這次也未使用任何憑證。CLI 可以幫你定位工具介面問題,卻不能證明 AI 主機的權限設定、資料範圍或整體部署已正確。先把伺服器測通,再另外驗證你要用的主機。
官方來源與測試範圍
本次為 Codex 在無發布憑證、非 root、斷網容器執行的合成資料測試,不代表站長親測。套件版本為 2.15.0;文件快照為 488c30d9d16e。