Trình kiểm tra máy chủ

📖 Nội dung bài học

Tóm tắt

Khi xây dựng máy chủ MCP, 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 đầy đủ. Bộ 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 máy chủ của mình trong thời gian thực.

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

Trước tiên, hãy đảm bảo môi trường Python của bạn đã được kích hoạt (kiểm tra tệp 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

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

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

Trình kiểm tra MCP đang được 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 nó. Tuy nhiên, chức năng cốt lõi vẫn nhất quán.

Khi bạn lần đầu mở trình kiểm tra, bạn sẽ thấy nút "Connect" (Kết nối) ở phía bên trái. Bấm vào đây để khởi động máy chủ MCP của bạn và tải các tool.

Kiểm tra các Tool của bạn

Sau khi kết nối, hãy tìm thanh điều hướng với các mục như Resources (Tài nguyên), Prompts (Lời nhắc) và Tools (Công cụ). Nhấp vào mục Tools để xem các tool có sẵn của bạn.

Nhấp vào "List Tools" (Liệt kê các Tool) để xem tất cả các tool mà máy chủ của bạn cung cấp. Khi bạn chọn một tool cụ thể, bảng bên phải sẽ cập nhật để hiển thị một biểu mẫu nơi bạn có thể kiểm tra tool đó.

Chạy Kiểm tra Tool

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

Chọn tool read_doc_contents
Nhập ID tài liệu (ví dụ: "deposition.md")
Nhấp vào "Run Tool" (Chạy Tool)

Trình kiểm tra sẽ thực thi tool của bạn và hiển thị kết quả, bao gồm trạng thái thành công và bất kỳ dữ liệu nào được trả về.

Kiểm tra Chỉnh sửa Tài liệu

Bạn cũng có thể kiểm tra các tool phức tạp hơn như chỉnh sửa tài liệu:

Chuyển sang tool edit_document
Điền ID tài liệu, văn bản cũ cần thay thế và văn bản mới
Chạy tool để xem nó có thành công không
Sử dụng tool đọc lại để xác minh các thay đổi đã được áp dụng

Quy trình Phát triển

Trình kiểm tra hiển thị lịch sử các lệnh gọi tool của bạn ở phía bên trái, giúp bạn dễ dàng theo dõi những gì bạn đã kiểm tra và lặp lại các thao tác trước đó. Điều này tạo ra một vòng lặp phát triển hiệu quả, nơi bạn có thể:

Thực hiện thay đổi đối với mã máy chủ của bạn
Khởi động lại trình kiểm tra
Kiểm tra các tool của bạn ngay lập tức
Xác minh kết quả

Công cụ trình kiểm tra này trở nên thiết yếu khi bạn xây dựng các máy chủ MCP phức tạp hơn. Nó loại bỏ nhu cầu kết nối máy chủ của bạn với một ứng dụng đầy đủ chỉ để kiểm tra chức năng cơ bản, giúp việc phát triển nhanh hơn và đáng tin cậy hơn nhiều.

🔁 Bài học liên quan

Bài tiếp: Implementing a client
Bài trước: Defining tools with MCP
Cùng section: Overview of Claude Models · Accessing the API · Making a request
Thuộc lộ trình: Path C
Docs tham khảo: Glossary · Skills atlas · By use-case

📚 Nguồn & ghi nhận

Bài học gốc Anthropic Academy: https://anthropic.skilljar.com/claude-in-amazon-bedrock/276796
Crawl: 2026-04-23 · Chuẩn hoá: 2026-05-01