MCP TypeScript SDK

MCP

MCPGitHubĐộ khó: Trung bìnhMiễn phí

MCP TypeScript SDK

4.0/5Đánh giá của 2dm

Phù hợp đội làm web với Node.js.

Thư viện chính thức để viết MCP server và client bằng TypeScript / Node.js.

Mở trang chính thức Xem cách dùng

Giới thiệu

MCP TypeScript SDK là bộ thư viện chính thức để xây MCP server và client bằng TypeScript. Từ v2, SDK tách thành các gói riêng: @modelcontextprotocol/server để xây server và @modelcontextprotocol/client để xây client, cùng các gói middleware tùy chọn cho Node, Express, Fastify và Hono.

Nhánh chính hiện là v2, bản ổn định triển khai đặc tả MCP 2026-07-28. SDK chạy được trên Node.js, Bun và Deno; server hỗ trợ stdio và Streamable HTTP, kèm công cụ hỗ trợ xác thực. Schema cho tool và prompt dùng chuẩn Standard Schema nên có thể chọn Zod v4, Valibot hoặc ArkType.

Nhánh v1.x (gói @modelcontextprotocol/sdk) vẫn được vá lỗi và bảo mật ít nhất sáu tháng sau ngày phát hành v2, nên dự án cũ có thời gian chuyển đổi.

Tính năng nổi bật

Gói tách riêng rõ ràng

server và client là hai gói độc lập, chỉ cài phần cần dùng.

Middleware cho web framework

Có gói tích hợp sẵn cho Node, Express, Fastify và Hono.

Đa runtime

Hỗ trợ Node.js, Bun và Deno.

Linh hoạt thư viện schema

Dùng Standard Schema, tương thích Zod v4, Valibot, ArkType.

Hỗ trợ xác thực

Có công cụ hỗ trợ auth phía server và OAuth phía client.

Lộ trình nâng cấp rõ

Có hướng dẫn chuyển từ v1 lên v2; v1.x vẫn được hỗ trợ một thời gian.

Dùng để làm gì

Thêm MCP vào backend sẵn có

Doanh nghiệp dùng Express hoặc Hono gắn MCP server vào API hiện tại.

Mở dữ liệu web app cho AI

Cho trợ lý AI đọc đơn hàng, lịch hẹn từ hệ thống viết bằng Node.js.

Xây công cụ cho đội kỹ thuật

Viết server stdio chạy cục bộ để AI hỗ trợ thao tác trên dự án.

Làm client trong sản phẩm

Ứng dụng của bạn tự kết nối tới các MCP server bên ngoài.

Chạy trên edge hoặc Deno

Triển khai server gọn nhẹ trên các runtime hiện đại.

Cách dùng

1
Cài gói server
Cài gói server bằng npm (hoặc bun add, deno add tương ứng).
$npm install @modelcontextprotocol/server
2
Cài gói client nếu cần
Chỉ cài khi ứng dụng của bạn cần kết nối tới MCP server khác.
$npm install @modelcontextprotocol/client
3
Chọn middleware
Nếu dùng Express, cài kèm gói tích hợp và express.
$npm install @modelcontextprotocol/express express
4
Viết server đầu tiên
Làm theo hướng dẫn first-server trong thư mục docs của repo hoặc tài liệu v2.
5
Nâng cấp từ v1
Dự án đang dùng @modelcontextprotocol/sdk nên đọc hướng dẫn migration lên v2.

Video hướng dẫn

The Ultimate MCP Crash Course - Build From Scratch
Web Dev Simplified

Build your first MCP Server in TypeScript
Roy Derks

Build a Real-world MCP Server with One TypeScript File Full Tutorial
Nader Dabit

Ví dụ thực tế

Tình huống minh hoạ

Một công ty dịch vụ spa ở Hà Nội có hệ thống đặt lịch viết bằng Node.js và Express. Lập trình viên cài @modelcontextprotocol/server cùng gói middleware Express, tạo tool tra lịch trống và resource mô tả danh sách dịch vụ. Lễ tân dùng trợ lý AI để kiểm tra khung giờ còn trống khi khách gọi điện, thay vì mở nhiều màn hình.

Mẹo & lưu ý

Dùng v2 cho dự án mới
v2 là nhánh ổn định trên main và theo đặc tả mới nhất.
Chỉ cài gói cần thiết
Tách server, client, middleware giúp ứng dụng gọn hơn.
Thống nhất thư viện schema
Chọn một thư viện như Zod v4 cho cả dự án để dễ bảo trì.
Lên kế hoạch rời v1
v1.x chỉ được đảm bảo vá lỗi tối thiểu sáu tháng sau ngày phát hành v2.