Hướng dẫn xây dựng MCP Server bằng Python với FastMCP

Giới thiệu về MCP và FastMCP

Model Context Protocol (MCP) là một giao thức chuẩn hóa mở cho phép các trợ lý AI (như Claude Desktop, Cursor) kết nối an toàn với các nguồn dữ liệu bên ngoài và các công cụ tùy chỉnh. Trong bài viết này, Bitech sẽ hướng dẫn bạn cách xây dựng một MCP Server bằng Python sử dụng framework FastMCP, kết nối cơ sở dữ liệu SQLite và tích hợp trực tiếp vào các công cụ phát triển.

Bước 1: Cài đặt môi trường phát triển

Trước tiên, bạn cần chuẩn bị môi trường Python (từ phiên bản 3.10 trở lên) và cài đặt thư viện FastMCP cùng các phụ thuộc cần thiết.

Chạy lệnh sau trong terminal:

pip install "mcp[cli]" fastmcp

Bước 2: Tạo MCP Server và kết nối SQLite

Tạo một file Python có tên server.py. Chúng ta sẽ khởi tạo một FastMCP Server đơn giản để truy vấn dữ liệu từ tệp SQLite.

import sqlite3
from mcp.server.fastmcp import FastMCP

# Khởi tạo MCP Server với tên 'SQLite-Manager'
mcp = FastMCP("SQLite-Manager")

DB_PATH = "example.db"

@mcp.tool()
def execute_read_query(query: str) -> str:
    """Thực thi câu lệnh SQL SELECT trên cơ sở dữ liệu SQLite và trả về kết quả."""
    if not query.strip().upper().startswith("SELECT"):
        return "Lỗi: Chỉ cho phép thực hiện truy vấn SELECT để đảm bảo an toàn."
    
    try:
        conn = sqlite3.connect(DB_PATH)
        cursor = conn.cursor()
        cursor.execute(query)
        rows = cursor.fetchall()
        conn.close()
        return str(rows)
    except Exception as e:
        return f"Lỗi truy vấn SQL: {str(e)}"

if __name__ == "__main__":
    mcp.run()

Bước 3: Kiểm thử MCP Server cục bộ

FastMCP đi kèm công cụ CLI tiện lợi để bạn chạy thử nghiệm server ngay trên giao diện Inspector:

fastmcp dev server.py

Lệnh này sẽ mở một giao diện web cho phép bạn gọi thử tool execute_read_query và kiểm tra phản hồi end-to-end trước khi tích hợp thực tế.

Bước 4: Tích hợp với Claude Desktop và Cursor

1. Tích hợp vào Claude Desktop

Mở hoặc tạo file cấu hình claude_desktop_config.json (nằm ở ~/Library/Application Support/Claude/ trên macOS hoặc %APPDATA%\Claude\ trên Windows) và thêm cấu hình server:

{
  "mcpServers": {
    "sqlite-tools": {
      "command": "python",
      "args": ["/duong_dan_toi/server.py"]
    }
  }
}

2. Tích hợp vào Cursor

Vào Cursor Settings > Features > MCP Servers, thêm một MCP Server mới:

• Type: command
• Name: sqlite-tools
• Command: python /duong_dan_toi/server.py

Kết luận

Chỉ với vài dòng code Python đơn giản sử dụng FastMCP, bạn đã tạo thành công một MCP Server có khả năng cung cấp dữ liệu từ SQLite cho Claude Desktop và Cursor. Việc này mở ra khả năng tự động hóa và truy vấn dữ liệu bằng ngôn ngữ tự nhiên ngay trong quy trình làm việc hàng ngày của bạn.

Ngày phát hành: 12/06/2026
Nguồn: www.digitalocean.com