Chuyển đến nội dung

PrefectHQ / fastmcp

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

FastMCP là thư viện Python giúp bạn tạo máy chủ MCP, tức là các công cụ mà trợ lý AI như Claude có thể gọi, chỉ bằng cách viết hàm Python thông thường. Nó tự lo lược đồ dữ liệu, kiểm tra đầu vào và giao thức. Hợp với lập trình viên muốn đưa dữ liệu hoặc nghiệp vụ nội bộ cho AI dùng.

  • 28.546 sao
  • 2.608 fork
  • Python
  • Cập nhật hôm nay
  • Apache 2.0 (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 FastMCP

Bạn thêm FastMCP vào dự án bằng uv, rồi viết vài dòng Python: tạo một đối tượng FastMCP, đánh dấu một hàm bằng decorator @mcp.tool, khai báo kiểu dữ liệu và docstring cho tham số. Ví dụ trong README là hàm cộng hai số; chỉ với đó bạn đã có một máy chủ MCP hoàn chỉnh.

Phần nặng nhọc như tạo mô tả công cụ cho AI, kiểm tra kiểu dữ liệu, thương lượng giao thức hay xác thực đều do thư viện lo. Bạn chỉ tập trung vào logic: lấy dữ liệu từ cơ sở dữ liệu nội bộ, gọi API công ty, đọc file Excel rồi trả về cho AI.

Ngoài máy chủ, FastMCP còn có client để kết nối đến máy chủ MCP bất kỳ, và Apps cho phép công cụ hiển thị giao diện tương tác ngay trong cuộc trò chuyện. Tài liệu đầy đủ ở gofastmcp.com, kể cả bản llms.txt để đưa cho trợ lý lập trình của bạn.

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

Hàm Python thành công cụ MCP

Chỉ cần decorator và type hint, thư viện tự sinh lược đồ, kiểm tra đầu vào và tài liệu cho AI.

Ba trụ cột: Servers, Clients, Apps

Servers xuất công cụ cho AI, Clients kết nối máy chủ MCP cục bộ hay từ xa, Apps cho công cụ hiển thị giao diện trong hội thoại.

Xử lý sẵn phần giao thức

Thương lượng transport, xác thực và vòng đời giao thức được quản lý để bạn khỏi phải tự viết.

Phiên bản TypeScript đi kèm

Cùng nhóm làm FastMCP cho TypeScript nếu bạn viết bằng Node.js.

Tài liệu thân thiện với AI

Có llms.txt và llms-full.txt để trợ lý lập trình đọc tài liệu và viết máy chủ MCP giúp bạn.

Tận dụng FastMCP vào việc gì?

Lập trình viên doanh nghiệp

Cho AI tra cứu dữ liệu nội bộ

Bọc truy vấn tồn kho hay tra cứu đơn hàng thành công cụ MCP để Claude hỏi trực tiếp.

Kỹ sư dữ liệu, DevOps

Biến script có sẵn thành công cụ cho AI

Chuyển các hàm Python xử lý báo cáo, tạo file thành công cụ MCP gọi được từ khung chat.

Đội làm sản phẩm SaaS

Tạo MCP server cho sản phẩm của bạn

Cung cấp cho khách hàng một cách để trợ lý AI của họ dùng dịch vụ của bạn.

Sinh viên, người mới

Học cách xây công cụ cho AI

Bắt đầu với ví dụ mười mấy dòng rồi mở rộng dần để hiểu MCP.

Cần chuẩn bị gì?

  • Python và công cụ uv (README khuyên dùng uv để thêm vào dự án).
  • Kiến thức Python cơ bản: hàm, type hint, decorator.
  • Một ứng dụng AI hỗ trợ MCP như Claude Desktop để thử máy chủ vừa viết.

Hướng dẫn cài đặt chi tiết

Cài trên uv

  1. Cài uv theo hướng dẫn của Astral nếu chưa có. Sau đó thêm FastMCP vào dự án Python của bạn.

    Terminal
    uv add fastmcp
  2. Hướng dẫn cài đặt đầy đủ, cách kiểm tra và nâng cấp nằm ở trang Installation Guide trên gofastmcp.com. Nếu bạn nâng cấp từ FastMCP 2, FastMCP 3 hoặc từ MCP SDK, README có trang hướng dẫn riêng cho từng trường hợp.

Cài trên Tạo máy chủ đầu tiên

  1. Tạo file server.py với nội dung ví dụ của README: một hàm cộng hai số được khai báo là công cụ.

    Python
    from fastmcp import FastMCP
    
    mcp = FastMCP("Demo")
    
    @mcp.tool
    def add(a: int, b: int) -> int:
        """Add two numbers"""
        return a + b
    
    if __name__ == "__main__":
        mcp.run()
  2. Chạy file để khởi động máy chủ. Mặc định nó giao tiếp qua kênh stdin nên có vẻ như đang chờ, vì nó đợi ứng dụng AI kết nối.

    Terminal
    python server.py
  3. Muốn gắn vào ứng dụng AI hay thử bằng giao diện kiểm tra, làm theo trang Quickstart trên gofastmcp.com.

Dùng thử lần đầu

  1. Thêm FastMCP vào một thư mục dự án thử bằng uv.

  2. Tạo server.py với ví dụ hàm add trong README rồi chạy thử.

  3. Mở trang Quickstart trên gofastmcp.com để biết cách kết nối máy chủ với một ứng dụng AI hoặc trình kiểm tra.

  4. Thay hàm add bằng một hàm hữu ích với bạn, ví dụ đọc một file CSV nhỏ và trả về thống kê, rồi nhờ AI gọi nó.

Mẹo dùng hay

  • Viết docstring rõ ràng và type hint chính xác, vì AI dựa vào chúng để hiểu khi nào và cách gọi công cụ.
  • Cho mỗi công cụ làm một việc nhỏ, tên rõ nghĩa, dễ cho AI chọn đúng.
  • Đưa llms.txt của FastMCP cho trợ lý lập trình của bạn để nó viết máy chủ đúng phiên bản.
  • Với máy chủ có quyền ghi dữ liệu, thêm xác nhận hoặc giới hạn quyền trước khi cho AI dùng thật.

Lưu ý và hạn chế

  • Đây là thư viện cho lập trình viên Python, không có giao diện cho người dùng cuối.
  • FastMCP đã trải qua nhiều phiên bản lớn (README có hướng dẫn nâng cấp từ 2 và 3); bài hướng dẫn cũ trên mạng có thể không còn khớp.
  • Công cụ bạn viết sẽ chạy với quyền của bạn; cần tự kiểm soát bảo mật khi để AI gọi các hàm truy cập dữ liệu nhạy cảm.

Câu hỏi thường gặp

FastMCP có miễn phí không?

Có, mã nguồn mở giấy phép Apache-2.0. Nhóm Prefect cũng có sản phẩm FastMCP Gateway trả phí cho doanh nghiệp, nhưng không bắt buộc.

Khác gì SDK Python chính thức của MCP?

FastMCP 1.0 từng được đưa vào SDK chính thức năm 2024; ngày nay FastMCP độc lập là khung đầy đủ hơn cho cả máy chủ, client và giao diện. SDK chính thức là lớp nền thấp hơn.

Tôi chưa biết lập trình có dùng được không?

Không phù hợp. Nếu chỉ muốn dùng công cụ MCP có sẵn thì xem các kho máy chủ mẫu hoặc danh sách awesome.

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/PrefectHQ/fastmcp.git

Repo tương tự nên xem

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

MCP Python SDK

modelcontextprotocol / python-sdk

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

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