Hướng dẫn tự code custom server Model Context Protocol MCP

—

bởi

Ứng dụng Model Context Protocol

Chuẩn kết nối mới: MCP là tiêu chuẩn do Anthropic đề xuất, giúp đơn giản hóa cách thiết lập kết nối giữa LLM với hệ thống tài liệu, API ngoài và database của bạn. Thay vì phải viết các code wrap API đặc thù cho từng model, bạn chỉ cần dựng đúng 1 chuẩn duy nhất.
Khả năng cấp quyền: Cho pháp Claude Code hoặc Cursor tự động đọc-ghi dữ liệu, chạy test và thao tác với file system của bạn an toàn dưới sự giám sát trực tiếp của người dùng.
Bảo mật cao: Tất cả các truy vấn được chạy cục bộ dưới dạng một tiến trình riêng biệt trong hệ thống của bạn, không để lộ thông tin bảo mật ra các server trung gian.

Hệ thống hoạt động thông qua việc kết nối luồng thông tin giữa máy chủ MCP và ứng dụng LLM (như Claude Code):

Khởi tạo: Tạo folder mới, chạy lệnh npm init -y và cài đặt SDK chính thức: npm install @modelcontextprotocol/sdk.
Định nghĩa Tools: Viết mã nguồn đăng ký các công cụ (tools) mà server của bạn cung cấp (ví dụ: read_user_db để đọc thông tin user từ cơ sở dữ liệu).
Viết logic chạy: Viết phần code thực thi tương ứng với từng tool, ví dụ viết câu lệnh SQL để lấy thông tin user khi tool được gọi.
Đăng ký vào Client: Cấu hình file config của Claude Code để hệ thống tự khởi chạy server mcp qua câu lệnh node /path/to/server.js.

Tối ưu: Biến mọi LLM trở thành một trợ lý toàn năng có quyền truy cập trực tiếp vào toàn bộ công cụ nội bộ của bạn mà không cần xây dựng middleware đắt đỏ.
Ứng dụng ngay:
Tự viết một MCP server nhỏ để kết nối với database Postgres đang dev để nhờ AI viết và chạy thử các query lấy số liệu thống kê nhanh.
Luôn kiểm tra tính hợp lệ của tham số đầu vào trước khi chạy bất kỳ hành động ghi hoặc xóa nào trên database.