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

Project setup

📖 Nội dung bài học

Tóm tắt

Chúng ta sẽ xây dựng một chatbot giao diện dòng lệnh (CLI-based chatbot) để hiểu rõ hơn về cách các MCP client và server hoạt động cùng nhau. Dự án thực hành này sẽ giúp bạn có kinh nghiệm thực tế với cả hai phía của kiến trúc MCP.

Chúng ta sẽ xây dựng cái gì

Chatbot của chúng ta sẽ cho phép người dùng tương tác với một tập hợp tài liệu thông qua giao diện dòng lệnh. Hệ thống bao gồm hai thành phần chính:

  • Một MCP client xử lý các tương tác của người dùng
  • Một MCP server tùy chỉnh quản lý các thao tác với tài liệu

Server sẽ cung cấp hai tool thiết yếu: một để đọc nội dung tài liệu và một để cập nhật chúng. Tất cả tài liệu sẽ được lưu trữ trong bộ nhớ (in-memory) để đơn giản hóa - không cần cơ sở dữ liệu.

Lưu ý quan trọng về kiến trúc

Trong các dự án thực tế, bạn thường chỉ triển khai MCP client hoặc MCP server, chứ không phải cả hai. Bạn có thể tạo:

  • Một MCP server để cung cấp dịch vụ của bạn cho các nhà phát triển khác
  • Một MCP client để kết nối với các MCP server hiện có

Chúng ta xây dựng cả hai thành phần trong dự án này thuần túy cho mục đích giáo dục - để hiểu cách chúng giao tiếp và hoạt động cùng nhau.

Thiết lập dự án

Tải tệp cli_project.zip đính kèm trong bài học này và giải nén vào thư mục phát triển của bạn. Mở trình soạn thảo mã nguồn trong thư mục dự án.

Dự án bao gồm một tệp README chi tiết với các hướng dẫn thiết lập. Hãy làm theo các bước sau:

  1. Thêm Anthropic API key của bạn vào tệp .env
  2. Cài đặt các thư viện phụ thuộc (dependencies) bằng UV (khuyên dùng) hoặc pip
  3. Chạy ứng dụng khởi đầu để xác nhận mọi thứ hoạt động bình thường

Chạy ứng dụng

Di chuyển đến thư mục dự án trong terminal. Bạn sẽ thấy các tệp chính của dự án bao gồm main.py, mcp_client.py, và mcp_server.py.

Để khởi động ứng dụng, hãy sử dụng một trong các lệnh sau:


uv run main.py

python main.py

Khi ứng dụng khởi động thành công, bạn sẽ thấy một prompt chat. Hãy thử bằng cách đặt một câu hỏi đơn giản như "1+1 bằng mấy?" - bạn sẽ nhận được phản hồi nhanh chóng từ Claude.

Sau khi hoàn tất thiết lập cơ bản, chúng ta đã sẵn sàng để bắt đầu triển khai các tính năng MCP và khám phá cách client và server giao tiếp thông qua Giao thức Điều khiển Mô hình (Model Control Protocol).

Tải xuống

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