MCP Inspector

MCP Inspector
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.
MCP Inspector là gì và dành cho ai?
Thư viện Tiện ích của OPCAIOS xếp MCP Inspector vào nhóm MCP: đây là một máy chủ MCP. Nhãn mô tả ngắn: GitHub. 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. 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. Đối tượng phù hợp: Lập trình viên xây và kiểm thử MCP server. Theo OPCAIOS, điểm đánh giá biên tập của MCP Inspector là 4,0/5: công cụ nên có khi chạy thử và gỡ lỗi server.
- Nền tảng: Node.js (chạy qua npx), web, terminal.
- Mức độ khó khi bắt đầu: trung bình.
MCP Inspector có miễn phí không và giá thế nào?
MCP Inspector là công cụ dùng miễn phí. Miễn phí, mã nguồn mở (đang chuyển từ MIT sang Apache-2.0). Ngoài ra, giá do nhà cung cấp quy định và có thể thay đổi, vì vậy hãy đối chiếu với trang chính thức của MCP Inspector trước khi trả tiền. Để so sánh chi phí, nhóm MCP trong thư viện còn có Model Context Protocol (miễn phí), MCP Servers (miễn phí) và Đặc tả MCP (miễn phí).
MCP Inspector có những tính năng nổi bật nào?
Theo OPCAIOS, điểm mạnh nổi bật của MCP Inspector là gọi thử tool trực quan, nhiều chế độ dùng và phù hợp tự động hóa, cùng một số điểm khác. Bên cạnh đó, danh sách dưới đây giải thích từng tính năng trong 5 tính năng đã ghi nhận.
- 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ó.
Nên dùng MCP Inspector trong những tình huống nào?
MCP Inspector là công cụ được áp dụng cho 4 nhóm công việc. Khi dùng MCP Inspector, trường hợp điển hình nhất là kiểm tra server trước khi bàn giao. Ngoài ra, nhóm người dùng chính là lập trình viên xây và kiểm thử MCP server.
- 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 bắt đầu dùng MCP Inspector gồm những bước nào?
Khi dùng MCP Inspector lần đầu, bạn đi qua 5 bước, độ khó được OPCAIOS xếp ở mức trung bình. Bước đầu tiên là mở giao diện web, bước cuối cùng là gọi thử và đọc kết quả. Các bước được liệt kê theo thứ tự dưới đây.
- Mở giao diện web. Chạy Inspector ở chế độ mặc định để kết nối và thử server.
- Dùng chế độ CLI. Dùng khi cần chạy kiểm tra bằng script hoặc trong CI.
- Dùng chế độ TUI. Giao diện ngay trong terminal cho người quen dòng lệnh.
- 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.
- 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.
MCP Inspector là gì?
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.
MCP Inspector giá bao nhiêu?
Miễn phí, mã nguồn mở (đang chuyển từ MIT sang Apache-2.0)
Giá do nhà cung cấp quy định và có thể thay đổi; xem trang chính thức để biết mức mới nhất.
Tính năng nổi bật của MCP Inspector
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ó.
MCP Inspector 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 MCP Inspector
- 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 dùng MCP Inspector
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ế khi dùng MCP Inspector
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 và lưu ý khi dùng MCP Inspector
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.
Câu hỏi thường gặp về MCP Inspector
Inspector có thay thế ứng dụng AI không?
Không, nó chỉ là công cụ kiểm tra để gọi thử server, không có mô hình AI trò chuyện.
Có cần cài đặt trước không?
Có thể chạy trực tiếp bằng npx.
mcpdo là gì?
Một CLI thử nghiệm cho phép chạy nhiều lệnh trên một kết nối có tên thông qua tiến trình nền cục bộ.
Giấy phép thế nào?
Dự án đang chuyển từ MIT sang Apache-2.0; đóng góp mới theo Apache-2.0, xem file LICENSE để biết chi tiết.
Liên kết hữu ích
Muốn áp dụng vào doanh nghiệp của bạn?
OPCAIOS khảo sát quy trình, chọn công cụ phù hợp và triển khai cùng đội ngũ của bạn. Buổi tư vấn đầu tiên miễn phí.
