Bỏ qua đến nội dung chính

The server inspector

📖 Nội dung bài học

Tóm tắt

Khi xây dựng các server MCP, bạn cần một cách để kiểm tra chức năng của mình mà không cần kết nối với một ứng dụng đầy đủ. SDK Python MCP bao gồm một trình kiểm tra dựa trên trình duyệt tích hợp sẵn, cho phép bạn gỡ lỗi và kiểm tra server của mình trong thời gian thực.

Bắt đầu Trình kiểm tra

Đầu tiên, hãy đảm bảo môi trường Python của bạn đã được kích hoạt (kiểm tra README của dự án để biết lệnh chính xác). Sau đó, chạy trình kiểm tra với:

mcp dev mcp_server.py

Thao tác này khởi động một server phát triển và cung cấp cho bạn một URL cục bộ, thường là một cái gì đó như http://127.0.0.1:6274. Mở URL này trong trình duyệt của bạn để truy cập Trình kiểm tra MCP.

Sử dụng Giao diện Trình kiểm tra

Giao diện trình kiểm tra đang được phát triển tích cực, vì vậy nó có thể trông khác khi bạn sử dụng nó. Tuy nhiên, chức năng cốt lõi vẫn nhất quán. Tìm các yếu tố chính sau:

  • Nút Connect để khởi động server MCP của bạn
  • Các tab điều hướng cho Resources, Tools, Prompts và các tính năng khác
  • Bảng liệt kê và kiểm tra công cụ

Nhấp vào nút Connect trước để khởi tạo server của bạn. Bạn sẽ thấy trạng thái kết nối thay đổi từ "Disconnected" thành "Connected".

Kiểm tra Tools của bạn

Điều hướng đến phần Tools và nhấp vào "List Tools" để xem tất cả các tools có sẵn từ server của bạn. Khi bạn chọn một tool, bảng bên phải sẽ hiển thị chi tiết và các trường đầu vào của nó.

Ví dụ, để kiểm tra một tool đọc tài liệu:

  1. Chọn tool read_doc_contents
  2. Nhập ID tài liệu (ví dụ: "deposition.md")
  3. Nhấp vào "Run Tool"
  4. Kiểm tra kết quả để biết thành công và kết quả mong đợi

Trình kiểm tra hiển thị cả trạng thái thành công và dữ liệu thực tế được trả về, giúp bạn dễ dàng xác minh tool của mình hoạt động chính xác.

Kiểm tra Tương tác Tool

Bạn có thể kiểm tra nhiều tool theo trình tự để xác minh quy trình làm việc phức tạp. Ví dụ: sau khi dùng tool chỉnh sửa để sửa đổi tài liệu, hãy kiểm tra ngay tool đọc để xác nhận các thay đổi đã được áp dụng chính xác.

Trình kiểm tra duy trì trạng thái server của bạn giữa các lần gọi tool, vì vậy các chỉnh sửa vẫn tồn tại và bạn có thể xác minh đầy đủ chức năng của server MCP của mình.

Quy trình phát triển

Trình kiểm tra MCP trở thành một phần thiết yếu trong quy trình phát triển của bạn. Thay vì viết các tập lệnh kiểm tra riêng biệt hoặc kết nối với các ứng dụng đầy đủ, bạn có thể:

  • Lặp lại nhanh chóng trên các triển khai tool
  • Kiểm tra các trường hợp biên và điều kiện lỗi
  • Xác minh tương tác tool và quản lý trạng thái
  • Gỡ lỗi các vấn đề trong thời gian thực

Vòng phản hồi tức thì này giúp việc phát triển server MCP hiệu quả hơn nhiều và giúp phát hiện các vấn đề sớm trong quá trình phát triển.

🔁 Bài học liên quan

📚 Nguồn & ghi nhận

Bài học có hữu ích không?

Góp ý / Báo lỗiPhát hiện sai sót hoặc có ý tưởng cải thiện?