MCP Inspector

MCP

MCPGitHubĐộ khó: Trung bìnhMiễn phí

MCP Inspector

4.0/5Đánh giá của 2dm

Công cụ nên có khi chạy thử và gỡ lỗi server.

Công cụ giao diện để chạy thử và gỡ lỗi MCP server trước khi gắn vào trợ lý AI.

Mở trang chính thức Xem cách dùng

Giới thiệu

MCP Inspector là công cụ dành cho lập trình viên để kiểm tra và gỡ lỗi MCP server. Bạn kết nối Inspector với server, xem danh sách tools, resources, prompts và gọi thử từng công cụ để chắc chắn server hoạt động đúng trước khi giao cho người dùng.

Tất cả nằm trong một gói @modelcontextprotocol/inspector với nhiều chế độ: giao diện web (mặc định), CLI để viết script và chạy trong CI, giao diện dòng lệnh TUI, và mcpdo đang thử nghiệm để chạy nhiều lệnh trên một kết nối có tên.

Inspector có quản lý OAuth token, client secret và biến môi trường của server; mặc định lưu vào keychain của hệ điều hành nếu có, còn trên máy không có keychain thì lưu ở file không mã hóa trừ khi bạn cung cấp khóa.

Tính năng nổi bật

Gọi thử tool trực quan

Giao diện web cho phép xem và chạy thử tools, resources, prompts của server.

Nhiều chế độ dùng

Web, CLI, TUI và mcpdo thử nghiệm trong cùng một gói.

Phù hợp tự động hóa

Chế độ CLI dùng được trong script, CI và vòng lặp agent.

Chạy không cần cài đặt

Khởi động trực tiếp qua npx.

Lưu bí mật qua keychain

OAuth token và secret mặc định được lưu vào keychain của hệ điều hành khi có.

Dùng để làm gì

Kiểm tra server trước khi bàn giao

Đội IT chạy thử từng tool để xác nhận server nội bộ trả kết quả đúng.

Gỡ lỗi kết nối

Xác định lỗi nằm ở server hay ở ứng dụng AI khi trợ lý không gọi được công cụ.

Kiểm thử tự động

Đưa chế độ CLI vào pipeline CI để phát hiện lỗi mỗi khi cập nhật server.

Đánh giá server bên thứ ba

Xem server công khai những tool nào trước khi cho phép dùng trong công ty.

Cách dùng

1
Mở giao diện web
Chạy Inspector ở chế độ mặc định để kết nối và thử server.
$npx @modelcontextprotocol/inspector
2
Dùng chế độ CLI
Dùng khi cần chạy kiểm tra bằng script hoặc trong CI.
$npx @modelcontextprotocol/inspector --cli
3
Dùng chế độ TUI
Giao diện ngay trong terminal cho người quen dòng lệnh.
$npx @modelcontextprotocol/inspector --tui
4
Cấu hình server cần kết nối
Khai báo server theo hướng dẫn cấu hình MCP server trong tài liệu của repo.
5
Gọi thử và đọc kết quả
Chọn từng tool, nhập tham số mẫu và kiểm tra phản hồi trước khi đưa vào sử dụng thật.

Video hướng dẫn

10 - MCP Inspector: Test and Debug your MCP Server Locally
AI Anytime

Build & Test a MCP Server with TypeScript and MCP Inspector
Roy Derks

How to test MCP server using MCP Inspector
Jaydeep Karale

Ví dụ thực tế

Tình huống minh hoạ

Một công ty logistics ở Bình Dương vừa viết MCP server cho phép tra trạng thái vận đơn. Trước khi cho nhân viên chăm sóc khách hàng dùng, lập trình viên mở Inspector, gọi thử tool tra vận đơn với vài mã mẫu và kiểm tra thông báo lỗi khi nhập sai mã. Sau đó họ thêm lệnh Inspector chế độ CLI vào quy trình CI để kiểm tra lại mỗi lần sửa server.

Mẹo & lưu ý

Kiểm tra nơi lưu bí mật
Trên máy chủ không có keychain, secret nằm ở file không mã hóa, hãy cung cấp khóa hoặc hạn chế quyền truy cập.
Dùng dữ liệu thử
Gọi tool bằng dữ liệu mẫu để tránh vô tình thay đổi dữ liệu thật.
Tự động hóa bằng CLI
Đưa chế độ CLI vào CI để không phải thử tay mỗi lần cập nhật.
Cần Node đủ mới khi phát triển
Muốn build từ mã nguồn, README yêu cầu Node 22.19.0 trở lên.