Chuyển đến nội dung

modelcontextprotocol / python-sdk

MCP Python SDK

Bộ công cụ Python chính thức để viết máy chủ và client Model Context Protocol cho AI

Đây là SDK Python chính thức của Model Context Protocol (MCP), giao thức chung giúp ứng dụng AI dùng công cụ và dữ liệu bên ngoài. Với nó, bạn viết máy chủ MCP xuất các công cụ, tài nguyên và prompt, hoặc viết client kết nối đến máy chủ bất kỳ, qua stdio, Streamable HTTP hay SSE. Dành cho lập trình viên Python.

  • 24.871 sao
  • 4.136 fork
  • Python
  • Cập nhật hôm nay
  • MIT (dùng tự do, kể cả thương mại)
Độ khó
Khó Dành cho người biết lập trình
Dạng
Thư viện lập trình
Chạy trên
Python
Chi phí
Miễn phí hoàn toàn

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

  1. 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.

    Terminal
    uv add "mcp[cli]"
  2. Cách khác bằng pip trong môi trường ảo.

    Terminal
    pip install "mcp[cli]"
  3. 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.

    Terminal
    uv run --with "mcp[cli]" mcp ...

Cài trên Máy chủ đầu tiên

  1. Tạo file server.py theo ví dụ README với một công cụ và một tài nguyên.

    Python
    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}!"
  2. Mở nó trong MCP Inspector để gọi thử.

    Terminal
    uv run mcp dev server.py
  3. Muốn chạy ở chế độ HTTP để client khác kết nối thì dùng lệnh dưới.

    Terminal
    uv run mcp run server.py --transport streamable-http

Dùng thử lần đầu

  1. Cài SDK vào một dự án thử rồi tạo file server.py như ví dụ.

  2. Chạy lệnh mcp dev và mở Inspector theo địa chỉ hiện trong Terminal.

  3. 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.

  4. Thử viết client theo ví dụ của README để gọi công cụ đó qua địa chỉ HTTP.

  5. Đọ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.

Terminal
git clone https://github.com/modelcontextprotocol/python-sdk.git

Repo tương tự nên xem

MCP: nối AI với công cụ28,5K

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

KhóPython
MCP: nối AI với công cụ92K

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

VừaNode.jsPythonWindowsmacOS+1
MCP: nối AI với công cụ97,8K

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...

DễWeb

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: MCP: nối AI với công cụ

MCP: nối AI với công cụ64,9K

Context7

upstash / context7

Đưa tài liệu thư viện mới nhất, đúng phiên bản vào trợ lý AI viết code để hết cảnh AI bịa hàm không tồn tại

VừaNode.jsWindowsmacOSLinux
MCP: nối AI với công cụ57,5K

Chrome DevTools MCP

ChromeDevTools / chrome-devtools-mcp

Cho trợ lý AI điều khiển và soi lỗi trang web trong Chrome thật: hiệu năng, console, mạng, ảnh chụp

VừaNode.jsWindowsmacOSLinux
MCP: nối AI với công cụ39,7K

Playwright MCP

microsoft / playwright-mcp

Cho trợ lý AI như Claude, Copilot, Cursor tự mở trình duyệt, bấm nút, điền form và đọc trang web giúp bạn

VừaNode.jsWindowsmacOSLinux
MCP: nối AI với công cụ34,6K

MCP for Blender (blender-mcp)

ahujasid / mcp-for-blender

Nối Claude hay AI khác vào Blender để dựng cảnh 3D, đổi vật liệu và tải mô hình bằng lời dặn

VừaWindowsmacOSLinuxPython
MCP: nối AI với công cụ34,5K

GitHub MCP Server

github / github-mcp-server

Máy chủ MCP chính thức của GitHub để AI đọc repo, quản lý issue, pull request và theo dõi Actions

VừaDockerWindowsmacOSLinux
MCP: nối AI với công cụ31,4K

Serena

oraios / serena

Bộ công cụ MCP cho AI viết code hiểu mã ở mức hàm, lớp như một IDE: tìm, sửa, đổi tên xuyên nhiều file

KhóPythonWindowsmacOSLinux

Xem cả 12 repo MCP: nối AI với công cụ Về Kho Repo