MCP Inspector: kiểm tra và gỡ lỗi MCP server bằng giao diện web, CLI hoặc TUI

MCP Inspector là công cụ dành cho lập trình viên cần kiểm tra một MCP server trước khi nối nó vào agent hoặc ứng dụng thật. Nó giúp bạn kết nối tới server, xem các khả năng được công bố, thử lời gọi và quan sát kết quả mà không phải tự viết một client kiểm thử từ đầu.

Điểm tiện nhất là cùng một gói @modelcontextprotocol/inspector cung cấp ba cách làm việc. Giao diện web phù hợp khi cần nhìn và thử từng thao tác. CLI dành cho script và CI. TUI mang trải nghiệm tương tác vào terminal, hữu ích khi bạn không muốn mở trình duyệt.

Ảnh minh họa do Tài Nguyên Số tạo để bổ sung ngữ cảnh cho bài viết.

Bạn có thể dùng nó vào việc gì?

Thử MCP server trong lúc phát triển

Khi vừa thêm tool hoặc thay đổi cấu hình server, bạn có thể mở Inspector bằng npx @modelcontextprotocol/inspector để kiểm tra trực quan. Cách này giảm việc phải sửa ứng dụng chính chỉ để xác nhận server có kết nối và phản hồi đúng hay không.

Tạo smoke test cho quy trình CI

Chế độ CLI phù hợp với luồng kết nối, liệt kê khả năng, gọi thử tool rồi kiểm tra kết quả. Đầu ra JSON có thể kết hợp với công cụ xử lý dòng lệnh như jq, giúp biến một lần kiểm tra thủ công thành bước xác minh lặp lại trong CI.

Gỡ lỗi ngay trong terminal

Nếu đang làm việc qua SSH hoặc muốn giữ mọi thứ trong cửa sổ dòng lệnh, bạn có thể chạy npx @modelcontextprotocol/inspector --tui. TUI cho phép tương tác với server mà không cần giao diện trình duyệt, nhưng vẫn thuận tiện hơn việc tự ghép từng lệnh kiểm tra rời rạc.

So sánh phản hồi trước và sau khi sửa server

Inspector cũng hữu ích khi bạn cần xác nhận một thay đổi không làm hỏng luồng hiện có. Hãy chạy lại cùng thao tác kết nối, liệt kê và gọi tool trước và sau khi sửa. Với CLI, các bước này có thể được ghi thành script để nhóm dùng chung.

Cần lưu ý

Inspector có thể quản lý token OAuth, OAuth client secret và các giá trị env của kết nối stdio. Theo mặc định, công cụ ưu tiên lưu chúng trong keychain của hệ điều hành nếu có.

Trên Linux thiếu dịch vụ lưu bí mật, phiên SSH, môi trường headless, Termux hoặc một số container, dữ liệu có thể chuyển sang tệp ~/.mcp-inspector/secrets.json. Tệp này không được mã hóa nếu bạn chưa cấu hình khóa. Vì vậy, trước khi nhập thông tin nhạy cảm, nên đọc tài liệu về secret storage và chọn cách lưu phù hợp, chẳng hạn mã hóa tệp hoặc chỉ giữ bí mật trong bộ nhớ.

Đây là công cụ thiên về kỹ thuật và sẽ hữu ích nhất khi bạn đã có MCP server hoặc cấu hình kết nối cần kiểm tra. Kho mã nguồn có tài liệu riêng cho cấu hình server, smoke test, OAuth, Docker và quá trình chuyển từ dòng v1 sang v2. Bạn nên xem hướng dẫn chính thức để chọn đúng chế độ và thiết lập an toàn cho môi trường của mình.