MCP Python SDK

MCP Python SDK
Cách nhanh để viết MCP server bằng Python.
Thư viện chính thức để viết MCP server và client bằng Python.
MCP Python SDK là gì và dành cho ai?
Thư viện Tiện ích của OPCAIOS xếp MCP Python SDK vào nhóm MCP: đây là một máy chủ MCP. Nhãn mô tả ngắn: GitHub. Thư viện chính thức để viết MCP server và client bằng Python. MCP Python SDK là bộ thư viện Python chính thức để xây cả MCP server lẫn MCP client. Với server, bạn khai báo tools, resources và prompts bằng các decorator đơn giản trên hàm Python có type hint; với client, bạn kết nối tới bất kỳ MCP server nào. Đối tượng phù hợp: Lập trình viên Python, đội tự động hóa. Theo OPCAIOS, điểm đánh giá biên tập của MCP Python SDK là 4,0/5: cách nhanh để viết MCP server bằng Python.
- Nền tảng: Python 3.10+ trên macOS, Windows, Linux.
- Mức độ khó khi bắt đầu: trung bình.
MCP Python SDK có miễn phí không và giá thế nào?
MCP Python SDK là công cụ dùng miễn phí. Miễn phí, mã nguồn mở (MIT). Ngoài ra, giá do nhà cung cấp quy định và có thể thay đổi, vì vậy hãy đối chiếu với trang chính thức của MCP Python SDK trước khi trả tiền. Để so sánh chi phí, nhóm MCP trong thư viện còn có Model Context Protocol (miễn phí), MCP Servers (miễn phí) và Đặc tả MCP (miễn phí).
MCP Python SDK có những tính năng nổi bật nào?
Theo OPCAIOS, điểm mạnh nổi bật của MCP Python SDK là chính thức, giấy phép MIT, khai báo bằng decorator và cả server và client, cùng một số điểm khác. Bên cạnh đó, danh sách dưới đây giải thích từng tính năng trong 6 tính năng đã ghi nhận.
- Chính thức, giấy phép MIT: SDK do dự án MCP phát triển, cấp phép MIT.
- Khai báo bằng decorator: Dùng @mcp.tool() và @mcp.resource() trên hàm Python để biến chúng thành công cụ và dữ liệu cho AI.
- Cả server và client: Vừa xây server, vừa có lớp Client để gọi tool của server khác.
- Ba kiểu truyền tải: Hỗ trợ stdio, Streamable HTTP và SSE.
- Lệnh mcp tiện lợi: mcp dev mở server trong Inspector, mcp run chạy server, mcp install cài vào ứng dụng.
- Có tài liệu nâng cấp: Trang tài liệu có mục giới thiệu v2 và hướng dẫn chuyển đổi.
Nên dùng MCP Python SDK trong những tình huống nào?
MCP Python SDK là công cụ được áp dụng cho 5 nhóm công việc. Khi dùng MCP Python SDK, trường hợp điển hình nhất là mở dữ liệu bán hàng cho AI. Ngoài ra, nhóm người dùng chính là lập trình viên Python, đội tự động hóa.
- Mở dữ liệu bán hàng cho AI: Viết tool Python truy vấn cơ sở dữ liệu đơn hàng để trợ lý AI trả lời câu hỏi doanh số.
- Tái dùng script có sẵn: Bọc các script xử lý Excel, báo cáo thành tool để nhân viên gọi qua AI.
- Kết nối hệ thống nội bộ: Tạo server gọi API phần mềm CRM hay kho của công ty.
- Xây agent riêng: Dùng phần Client để ứng dụng Python của bạn gọi tool từ nhiều MCP server.
- Triển khai server từ xa: Chạy server qua Streamable HTTP để nhiều người trong công ty dùng chung.
Cách bắt đầu dùng MCP Python SDK gồm những bước nào?
Khi dùng MCP Python SDK lần đầu, bạn đi qua 5 bước, độ khó được OPCAIOS xếp ở mức trung bình. Bước đầu tiên là cài SDK bằng uv, bước cuối cùng là chạy qua HTTP. Các bước được liệt kê theo thứ tự dưới đây.
- Cài SDK bằng uv. Dự án dùng uv có thể thêm gói kèm phần CLI.
- Hoặc cài bằng pip. Dùng pip nếu không dùng uv; bỏ phần [cli] nếu không cần lệnh mcp.
- Viết server tối thiểu. Tạo file server.py, khởi tạo MCPServer và gắn @mcp.tool() cho hàm có type hint.
- Thử trong Inspector. Mở server trong MCP Inspector để gọi thử tool trước khi nối vào ứng dụng AI.
- Chạy qua HTTP. Phục vụ server bằng Streamable HTTP, endpoint mặc định trong README là localhost:8000/mcp.
MCP Python SDK là gì?
MCP Python SDK là bộ thư viện Python chính thức để xây cả MCP server lẫn MCP client. Với server, bạn khai báo tools, resources và prompts bằng các decorator đơn giản trên hàm Python có type hint; với client, bạn kết nối tới bất kỳ MCP server nào.
SDK yêu cầu Python 3.10 trở lên, hỗ trợ các kiểu truyền tải stdio, Streamable HTTP và SSE. Gói kèm phần mở rộng cli cung cấp lệnh mcp để chạy server, mở MCP Inspector hoặc cài server vào ứng dụng AI.
Đây là lựa chọn phù hợp cho doanh nghiệp đã có sẵn script Python, hệ thống dữ liệu hoặc tự động hóa bằng Python và muốn mở chúng ra cho trợ lý AI sử dụng.
MCP Python SDK giá bao nhiêu?
Miễn phí, mã nguồn mở (MIT)
Giá do nhà cung cấp quy định và có thể thay đổi; xem trang chính thức để biết mức mới nhất.
Tính năng nổi bật của MCP Python SDK
Chính thức, giấy phép MIT
SDK do dự án MCP phát triển, cấp phép MIT.
Khai báo bằng decorator
Dùng @mcp.tool() và @mcp.resource() trên hàm Python để biến chúng thành công cụ và dữ liệu cho AI.
Cả server và client
Vừa xây server, vừa có lớp Client để gọi tool của server khác.
Ba kiểu truyền tải
Hỗ trợ stdio, Streamable HTTP và SSE.
Lệnh mcp tiện lợi
mcp dev mở server trong Inspector, mcp run chạy server, mcp install cài vào ứng dụng.
Có tài liệu nâng cấp
Trang tài liệu có mục giới thiệu v2 và hướng dẫn chuyển đổi.
MCP Python SDK dùng để làm gì?
Mở dữ liệu bán hàng cho AI
Viết tool Python truy vấn cơ sở dữ liệu đơn hàng để trợ lý AI trả lời câu hỏi doanh số.
Tái dùng script có sẵn
Bọc các script xử lý Excel, báo cáo thành tool để nhân viên gọi qua AI.
Kết nối hệ thống nội bộ
Tạo server gọi API phần mềm CRM hay kho của công ty.
Xây agent riêng
Dùng phần Client để ứng dụng Python của bạn gọi tool từ nhiều MCP server.
Triển khai server từ xa
Chạy server qua Streamable HTTP để nhiều người trong công ty dùng chung.
Cách dùng MCP Python SDK
- 1
Cài SDK bằng uv
Dự án dùng uv có thể thêm gói kèm phần CLI.
$uv add "mcp[cli]" - 2
Hoặc cài bằng pip
Dùng pip nếu không dùng uv; bỏ phần [cli] nếu không cần lệnh mcp.
$pip install "mcp[cli]" - 3
Viết server tối thiểu
Tạo file server.py, khởi tạo MCPServer và gắn @mcp.tool() cho hàm có type hint.
- 4
Thử trong Inspector
Mở server trong MCP Inspector để gọi thử tool trước khi nối vào ứng dụng AI.
$uv run mcp dev server.py - 5
Chạy qua HTTP
Phục vụ server bằng Streamable HTTP, endpoint mặc định trong README là localhost:8000/mcp.
$uv run mcp run server.py --transport streamable-http
Video hướng dẫn dùng MCP Python SDK
Intro to MCP Servers – Model Context Protocol with Python Course
freeCodeCamp.org
Build Anything With a CUSTOM MCP Server - Python Tutorial
Tech With Tim
Python + MCP: Building MCP servers with FastMCP
Microsoft Reactor
Ví dụ thực tế khi dùng MCP Python SDK
Một chuỗi cửa hàng mỹ phẩm ở TP.HCM có sẵn script Python tổng hợp doanh thu theo chi nhánh. Lập trình viên bọc hàm đó thành tool bằng MCP Python SDK, thử trong Inspector, rồi chạy server qua Streamable HTTP trên máy chủ nội bộ. Quản lý vùng hỏi trợ lý AI về doanh thu chi nhánh tuần trước và AI gọi đúng hàm đã có thay vì nhân viên phải chạy tay.
Mẹo và lưu ý khi dùng MCP Python SDK
Viết type hint đầy đủ
SDK dựa vào kiểu dữ liệu của hàm để mô tả tham số cho AI.
Đặt tên và mô tả tool rõ ràng
Mô tả tốt giúp mô hình chọn đúng công cụ.
Luôn thử bằng mcp dev
Kiểm tra tool trong Inspector trước khi đưa cho người dùng.
Xem tài liệu v2
Nếu theo hướng dẫn cũ, đối chiếu trang migration vì ví dụ hiện dùng MCPServer.
Câu hỏi thường gặp về MCP Python SDK
Cần Python phiên bản nào?
Python 3.10 trở lên.
Có bắt buộc cài phần [cli] không?
Không. Chỉ cần nếu bạn muốn dùng lệnh mcp như mcp dev, mcp run, mcp install.
SDK có miễn phí không?
Có, mã nguồn mở theo giấy phép MIT.
Có thể làm client không?
Có, SDK cung cấp lớp Client để kết nối và gọi tool trên server HTTP hoặc stdio.
Liên kết hữu ích
Muốn áp dụng vào doanh nghiệp của bạn?
OPCAIOS khảo sát quy trình, chọn công cụ phù hợp và triển khai cùng đội ngũ của bạn. Buổi tư vấn đầu tiên miễn phí.
