Trải nghiệm khi dùng MCP Python SDK
Bạn cài gói bằng uv hoặc pip, rồi tạo file server.py với vài dòng: khởi tạo một đối tượng máy chủ, gắn decorator cho một hàm để trở thành công cụ, và một hàm khác thành tài nguyên có tham số trong địa chỉ. README gọi đó là một máy chủ hoàn chỉnh trong 15 dòng, vì kiểu dữ liệu và docstring đã đủ để SDK tự dựng lược đồ.
Để thử mà không cần ứng dụng AI, bạn chạy trình kiểm tra MCP Inspector bằng lệnh uv run mcp dev server.py. Bạn mở nó lên, gọi công cụ add với hai số và nhận lại kết quả. Cách này giúp nhìn rõ AI sẽ thấy công cụ của bạn ra sao.
Cùng gói đó cũng là một client đầy đủ: bạn chạy máy chủ ở chế độ HTTP, rồi viết vài dòng Python để kết nối bằng một địa chỉ và gọi công cụ. Tài liệu chi tiết, hướng dẫn nhập môn và hướng dẫn di chuyển nằm ở py.sdk.modelcontextprotocol.io.
Tính năng nổi bật
Viết máy chủ MCP bằng Python
Xuất công cụ, tài nguyên và prompt cho bất kỳ ứng dụng nào hiểu MCP, chỉ bằng hàm và type hint.
Viết client MCP
Kết nối đến máy chủ MCP bất kỳ, cục bộ qua stdio hoặc từ xa qua địa chỉ HTTP.
Đủ các transport chuẩn
Hỗ trợ stdio, Streamable HTTP và SSE nên dùng được cho cả máy chủ chạy trên máy lẫn dịch vụ triển khai.
Công cụ dòng lệnh mcp
Gói tuỳ chọn cli thêm lệnh mcp dev, mcp run, mcp install để thử và cài máy chủ nhanh.
Tài liệu kèm hướng dẫn di chuyển
Có trang giới thiệu phiên bản 2 và hướng dẫn nâng cấp cho người đang dùng bản cũ.
Tận dụng MCP Python SDK vào việc gì?
Lập trình viên doanh nghiệp
Cho AI dùng dữ liệu nội bộ
Viết máy chủ đọc dữ liệu từ hệ thống của công ty và để trợ lý AI gọi.
Lập trình viên làm ứng dụng AI
Xây trợ lý riêng kết nối nhiều công cụ
Dùng client của SDK để ứng dụng của bạn nối vào nhiều máy chủ MCP có sẵn.
Người phát triển công cụ cho AI
Kiểm thử và gỡ lỗi máy chủ MCP
Dùng mcp dev và Inspector để xem công cụ hoạt động thế nào trước khi đưa cho người dùng.
Sinh viên, người mới với MCP
Học giao thức từ nguồn chính thức
Đọc mã nguồn và tài liệu chính thức để hiểu cách MCP vận hành.
Cần chuẩn bị gì?
- Python 3.11 trở lên.
- uv hoặc pip để cài; README khuyên dùng uv.
- Node.js nếu muốn dùng MCP Inspector qua npx.
- Kiến thức Python cơ bản và hiểu khái niệm công cụ, tài nguyên trong MCP.
Hướng dẫn cài đặt chi tiết
Cài trên uv hoặc pip
Cài SDK cùng công cụ dòng lệnh mcp. README dùng uv; nếu không có uv thì dùng pip.
uv add "mcp[cli]"Cách khác bằng pip trong môi trường ảo.
pip install "mcp[cli]"Chỉ cần SDK không cần lệnh mcp thì cài gói mcp trơn. Muốn chạy thử một lệnh mà không tạo dự án, dùng uv run --with như dưới.
uv run --with "mcp[cli]" mcp ...
Cài trên Máy chủ đầu tiên
Tạo file server.py theo ví dụ README với một công cụ và một tài nguyên.
from mcp.server import MCPServer mcp = MCPServer("Demo") @mcp.tool() def add(a: int, b: int) -> int: """Add two numbers.""" return a + b @mcp.resource("greeting://{name}") def greeting(name: str) -> str: """Greet someone by name.""" return f"Hello, {name}!"Mở nó trong MCP Inspector để gọi thử.
uv run mcp dev server.pyMuốn chạy ở chế độ HTTP để client khác kết nối thì dùng lệnh dưới.
uv run mcp run server.py --transport streamable-http
Dùng thử lần đầu
Cài SDK vào một dự án thử rồi tạo file server.py như ví dụ.
Chạy lệnh mcp dev và mở Inspector theo địa chỉ hiện trong Terminal.
Gọi công cụ add với a bằng 1 và b bằng 2; bạn sẽ nhận kết quả là 3.
Thử viết client theo ví dụ của README để gọi công cụ đó qua địa chỉ HTTP.
Đọc trang What's new in v2 và hướng dẫn di chuyển nếu bạn đang có mã viết bằng bản cũ.
Mẹo dùng hay
- Khai báo kiểu dữ liệu và docstring thật rõ; chính chúng thành lược đồ công cụ mà AI đọc.
- Bắt đầu với stdio cho máy chủ chạy cục bộ, và dùng Streamable HTTP khi triển khai cho nhiều người dùng.
- Nếu muốn nhiều tính năng cấp cao như giao diện và xác thực dựng sẵn, xem thêm FastMCP.
- Dùng Inspector thường xuyên để kiểm tra những gì AI sẽ thấy.
Lưu ý và hạn chế
- Chỉ dành cho lập trình viên Python; không có giao diện cho người dùng cuối.
- README nhắc đến phiên bản 2 và hướng dẫn di chuyển, nên mã và bài viết cũ có thể khác API hiện tại.
- Công cụ bạn viết chạy với quyền của bạn, hãy kiểm soát quyền truy cập khi để AI gọi các hàm nhạy cảm.
Câu hỏi thường gặp
Có miễn phí không?
Có, giấy phép MIT và không tính phí.
Khác gì FastMCP?
SDK chính thức là nền tảng giao thức. FastMCP là một khung độc lập do nhóm khác duy trì, nhiều tính năng cấp cao hơn; cả hai đều dùng được để viết máy chủ MCP.
Tôi dùng JavaScript hay ngôn ngữ khác thì sao?
Nhóm MCP có SDK cho nhiều ngôn ngữ như TypeScript, Go, Java, Kotlin, C#, PHP, Ruby, Rust và Swift, liệt kê trong README kho máy chủ tham chiếu.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/modelcontextprotocol/python-sdk.gitRepo tương tự nên xem
FastMCP
PrefectHQ / fastmcp
Khung Python để viết MCP server và client nhanh: viết một hàm Python là có công cụ cho AI dùng
MCP Reference Servers
modelcontextprotocol / servers
Bộ máy chủ MCP mẫu chính thức: đọc file, lấy nội dung web, Git, bộ nhớ, giờ giấc cho Claude và các AI khác
Awesome MCP Servers
punkpeye / awesome-mcp-servers
Danh sách tuyển chọn hàng nghìn máy chủ MCP để cho AI dùng file, trình duyệt, cơ sở dữ liệu, ứng dụng...