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 MCP server, bạn cần một cách để kiểm tra chức năng mà không cần kết nối với một ứng dụng hoàn chỉnh. Python MCP SDK có một trình kiểm tra (inspector) tích hợp sẵn, chạy trên trình duyệt, cho phép bạn debug và kiểm tra server của mình theo thời gian thực.

Khởi chạy Inspector

Đầ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 lệnh chính xác trong README của dự án). Sau đó, chạy inspector với lệnh:

mcp dev mcp_server.py

Lệnh này sẽ khởi chạy một development server và cung cấp cho bạn một URL cục bộ (thường là trên cổng 6277) để truy cập inspector trong trình duyệt.

Sử dụng giao diện Inspector

MCP inspector đang trong quá trình phát triển tích cực, vì vậy giao diện có thể trông khác khi bạn sử dụng. Tuy nhiên, chức năng cốt lõi vẫn nhất quán.

Sau khi bấm "Connect" để khởi chạy MCP server, bạn sẽ thấy một thanh điều hướng với các mục:

  • Resources
  • Prompts
  • Tools
  • Các khả năng khác của server

Kiểm tra Tools của bạn

Mục Tools là nơi bạn sẽ dành phần lớn thời gian debug. Bấm "List Tools" để xem tất cả các tool mà server của bạn cung cấp.

Khi bạn chọn một tool, bảng bên phải sẽ hiển thị chi tiết và cung cấp các trường nhập liệu để kiểm tra. Ví dụ, để kiểm tra tool read_doc_contents:

  1. Chọn tool từ danh sách
  2. Nhập ID tài liệu (ví dụ: "deposition.md")
  3. Bấm "Run Tool"
  4. Kiểm tra kết quả để xem có thành công và có đúng như mong đợi không

Kiểm tra Tương tác giữa các Tools

Bạn có thể kiểm tra nhiều tool theo trình tự để xác minh chúng hoạt động cùng nhau chính xác. Ví dụ, sau khi sử dụng tool edit_document để sửa đổi nội dung:

Chạy lại tool read_doc_contents với cùng ID tài liệu để xác nhận các thay đổi của bạn đã được áp dụng:

Quy trình Phát triển

Inspector tạo ra một vòng lặp phát triển hiệu quả:

  • Thực hiện thay đổi đối với mã MCP server của bạn
  • Kiểm tra từng tool với các đầu vào khác nhau
  • Xác minh các tương tác giữa các tool hoạt động như mong đợi
  • Debug các vấn đề mà không cần thiết lập ứng dụng hoàn chỉnh

Môi trường kiểm tra dựa trên trình duyệt này là cần thiết cho việc phát triển MCP server. Nó giúp tiết kiệm thời gian bằng cách cho phép bạn phát hiện sớm các vấn đề và xác minh chức năng trước khi tích hợp với Claude hoặc các ứng dụng khác.

🔁 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?