Nếu bạn đang hào hứng về Qwen 3 và khả năng hỗ trợ MCP (Model-Context-Protocol) sáng bóng của nó, thì bạn sắp được thưởng thức một điều tuyệt vời! Gần đây tôi đã tìm hiểu sâu về các khả năng của Qwen 3 trên máy tính windows của mình, và tôi phải nói rằng—đó là một bước đột phá để xây dựng các tác nhân AI tương tác với các công cụ như cơ sở dữ liệu SQLite. Trong hướng dẫn này, chúng ta sẽ khám phá cách Qwen 3 tận dụng MCP để làm cho công việc lập trình của bạn trở nên dễ dàng hơn, với một ví dụ thực tế về truy vấn cơ sở dữ liệu. Chúng ta cũng sẽ đề cập đến các điểm chuẩn ấn tượng của Qwen 3 và chỉ cho bạn cách sử dụng OpenRouter và Roo Code để bắt đầu nhanh chóng. Sẵn sàng biến Qwen 3 và MCP thành những người bạn thân mới của bạn chưa? Hãy cùng bắt đầu nào!
Qwen 3 với Hỗ trợ MCP là gì?
Qwen 3 là loạt mô hình ngôn ngữ lớn mới nhất từ nhóm Qwen của Alibaba Cloud, được phát hành vào cuối tháng 4 năm 2025. Đây là một cỗ máy mạnh mẽ với các mô hình có kích thước từ 0.6B đến 235B tham số, bao gồm các biến thể dày đặc (dense) và Hỗn hợp chuyên gia (Mixture-of-Experts - MoE) như Qwen3-235B-A22B (22B tham số hoạt động). Theo qwen3.org, Qwen 3 cạnh tranh với các mô hình hàng đầu như DeepSeek-R1, o1, o3-mini của OpenAI, Grok-3 và Gemini-2.5-Pro trong các tác vụ lập trình, toán học và tổng quát. Mô hình MoE nhỏ hơn của nó, Qwen3-30B-A3B, thậm chí còn vượt trội hơn QwQ-32B mặc dù có ít hơn 10 lần tham số hoạt động—khá ấn tượng, phải không?

Điều khiến Qwen 3 trở nên đặc biệt thú vị là khả năng hỗ trợ MCP, cho phép nó tương tác liền mạch với các công cụ bên ngoài như cơ sở dữ liệu SQLite, bộ nhớ và hệ thống tệp. MCP (Model-Context-Protocol) cho phép Qwen 3 gọi các công cụ dựa trên máy chủ, kích hoạt các quy trình làm việc dạng tác nhân (agentic workflows) nơi mô hình có thể tìm nạp dữ liệu, chạy lệnh và nhiều hơn nữa. Các bài đăng trên X đang xôn xao về tính năng này, với người dùng ghi nhận sự tối ưu hóa của nó cho việc gọi hàm nâng cao và khả năng tác nhân. Hãy thiết lập nó và xem nó hoạt động như thế nào với một ví dụ truy vấn cơ sở dữ liệu!
Thiết lập Môi trường của Bạn để Làm việc với Qwen 3: Những Điều Cơ bản
Hãy chuẩn bị hệ thống của bạn để sử dụng Qwen 3 với MCP. Đừng lo lắng—tôi sẽ hướng dẫn từng bước để bạn không bị lạc.
Kiểm tra các Yêu cầu Tiên quyết: Đảm bảo bạn đã cài đặt các công cụ sau:
- Python: Phiên bản 3.10 trở lên. Chạy
python --version
trong terminal của bạn. Nếu thiếu, hãy tải về từ python.org. - Node.js: Cần thiết cho một số máy chủ MCP. Kiểm tra bằng
node --version
hoặc tải về từ nodejs.org. - uv: Phiên bản 0.4.18 trở lên để chạy máy chủ MCP. Xác minh bằng
uv --version
. Cài đặt quapip install uv
nếu cần. - Git: Để clone các kho lưu trữ (repo). Kiểm tra bằng
git --version
hoặc cài đặt bằng Homebrew (brew install git
trên Mac) hoặc winget (winget install git.git
trên Windows). - SQLite: Cho ví dụ của chúng ta. Xác nhận bằng
sqlite3 --version
hoặc cài đặt qua Homebrew (brew install sqlite3
) hoặc winget (winget install sqlite.sqlite
). - Phần cứng: CPU 4+ lõi, RAM 16GB+, và 10GB+ dung lượng trống để xử lý AI.
Tạo một Thư mục Dự án: Hãy giữ mọi thứ gọn gàng:
mkdir qwen3-mcp
cd qwen3-mcp
Thư mục này sẽ là không gian làm việc của bạn cho sự kỳ diệu của Qwen 3 và MCP.
Thiết lập Môi trường Ảo: Để tránh xung đột phụ thuộc, hãy tạo một môi trường ảo Python:
python -m venv venv
Kích hoạt nó:
- Mac/Linux:
source venv/bin/activate
- Windows:
venv\Scripts\activate
Dấu nhắc (venv)
trong terminal của bạn có nghĩa là bạn đã sẵn sàng.
Cài đặt Qwen-Agent để Hỗ trợ MCP
Qwen 3 sử dụng framework Qwen-Agent để kích hoạt hỗ trợ MCP, như đã ghi nhận trên GitHub. Hãy cài đặt nó và thiết lập các phụ thuộc cho ví dụ SQLite của chúng ta.

Cài đặt Qwen-Agent với Hỗ trợ MCP:
pip install -U "qwen-agent[gui,rag,code_interpreter,mcp]"
Lệnh này cài đặt Qwen-Agent với tất cả các phụ thuộc tùy chọn, bao gồm [mcp]
cho hỗ trợ MCP, [gui]
cho giao diện web (web UI), [rag]
cho tạo sinh tăng cường truy xuất (retrieval-augmented generation), và [code_interpreter]
để chạy mã.
Xác minh Cài đặt: Đảm bảo Qwen-Agent đã cài đặt đúng bằng cách chạy:
python -c "import qwen_agent; print(qwen_agent.__version__)"
Nếu bạn thấy một số phiên bản (ví dụ: 0.1.0), bạn đã thành công. Nếu không, hãy cài đặt lại hoặc kiểm tra môi trường Python của bạn.
Cấu hình Qwen 3 với Máy chủ MCP
Bây giờ, hãy cấu hình Qwen 3 để làm việc với một máy chủ MCP cho việc gọi công cụ. Chúng ta sẽ sử dụng ví dụ SQLite từ kho lưu trữ Qwen-Agent GitHub để truy vấn cơ sở dữ liệu.
Thiết lập Máy chủ MCP cho SQLite:
Ví dụ sử dụng một máy chủ MCP để xử lý tương tác với cơ sở dữ liệu SQLite. Đầu tiên, tạo một cơ sở dữ liệu thử nghiệm (test.db
) nếu bạn chưa có:
sqlite3 test.db "CREATE TABLE example (id INTEGER PRIMARY KEY, name TEXT); INSERT INTO example (name) VALUES ('Alice'), ('Bob');"
Bây giờ, khởi động máy chủ SQLite MCP:
uvx mcp-server-sqlite --db-path test.db
Lệnh này chạy máy chủ SQLite MCP, cho phép Qwen 3 truy vấn test.db
. Giữ terminal này đang chạy.
Cấu hình Qwen 3 trong Mã của Bạn:
Hãy viết một script Python để sử dụng Qwen 3 với máy chủ MCP, dựa trên ví dụ assistant_mcp_sqlite_bot.py
. Tạo một tệp có tên qwen3_mcp_sqlite.py
:
import os
from qwen_agent.agents import Assistant
from qwen_agent.gui import WebUI
# Define the agent with Qwen 3 and MCP configuration
def init_agent_service():
llm_cfg = {
'model': 'qwen3-32b', # Use Qwen 3 model
'model_type': 'qwen_dashscope',
'api_key': os.getenv('DASHSCOPE_API_KEY'),
}
tools = [{
'mcpServers': {
'sqlite': {
'command': 'uvx',
'args': ['mcp-server-sqlite', '--db-path', 'test.db']
}
}
}]
bot = Assistant(
llm=llm_cfg,
function_list=tools,
name='MCP-SQLite-Bot',
description='This bot can answer questions by SQLite database'
)
return bot
# Test the agent with a query
def test(query='How many tables are in the database?'):
bot = init_agent_service()
messages = [{'role': 'user', 'content': query}]
for response in bot.run(messages=messages):
print(response)
# Run a web UI for interactive testing
def app_gui():
bot = init_agent_service()
WebUI(bot).run()
if __name__ == '__main__':
test()
# Uncomment to run the web UI
# app_gui()
Script này thiết lập Qwen 3 (cụ thể là qwen3-32b
) để làm việc với máy chủ SQLite MCP. Nó định nghĩa một bot có thể truy vấn cơ sở dữ liệu và bao gồm tùy chọn giao diện web (web UI) để kiểm thử tương tác.
Đặt Khóa API DashScope:
Script sử dụng dịch vụ DashScope của Alibaba Cloud cho Qwen 3. Bạn sẽ cần một khóa API DashScope:
- Đăng ký tại dashscope.aliyuncs.com.
- Điều hướng đến cài đặt API, tạo khóa và đặt nó làm biến môi trường:
export DASHSCOPE_API_KEY="your-dashscope-api-key"
Thêm dòng này vào hồ sơ shell của bạn (ví dụ: ~/.zshrc
) và tải lại bằng source ~/.zshrc
.
Sử dụng OpenRouter và Roo Code cho Qwen 3 với MCP
Nếu bạn không muốn bận tâm với DashScope, bạn có thể sử dụng OpenRouter để truy cập Qwen 3 và tận dụng máy chủ MCP đã được cấu hình sẵn của Roo Code. Cách thực hiện như sau:
Lấy Khóa API OpenRouter:
- Truy cập openrouter.ai và đăng ký.
- Vào cài đặt tài khoản của bạn, tạo khóa API và sao chép nó.
Thiết lập Roo Code với OpenRouter:
Roo Code là một nền tảng đơn giản hóa quy trình làm việc của tác nhân AI và thường đi kèm với các máy chủ MCP được cấu hình sẵn. Giả sử bạn đã thiết lập Roo Code:
- Cấu hình khóa API OpenRouter của bạn trong cài đặt của Roo Code (thường nằm dưới mục tích hợp API).
- Cập nhật cấu hình mô hình trong Roo Code để sử dụng Qwen 3 thông qua OpenRouter:
{
"model": "qwen3-32b",
"model_server": "https://openrouter.ai/api/v1",
"api_key": "your-openrouter-api-key"
}
- Roo Code thường có thiết lập máy chủ MCP tương tự như trong script của chúng ta. Kiểm tra tài liệu của nó để đảm bảo máy chủ SQLite đang chạy (ví dụ:
uvx mcp-server-sqlite --db-path test.db
).
Chạy Script Tương tự với Roo Code:
Sửa đổi llm_cfg
trong script qwen3_mcp_sqlite.py
của bạn để sử dụng OpenRouter:
llm_cfg = {
'model': 'qwen3-32b',
'model_server': 'https://openrouter.ai/api/v1',
'api_key': 'your-openrouter-api-key'
}
Chạy script như trước—máy chủ MCP của Roo Code sẽ xử lý các truy vấn SQLite, và Qwen 3 sẽ xử lý chúng thông qua OpenRouter.
Tùy chọn 2: Cấu hình Roo Code để Làm việc với OpenRouter:
Nếu bạn không muốn sử dụng script tùy chỉnh, bạn có thể dễ dàng thiết lập Roo Code với OpenRouter bằng cách làm theo các bước sau:
- Mở cài đặt của Roo.
- Thay đổi nhà cung cấp mặc định thành OpenRouter.
- Chọn mô hình Qwen 3.

Sau khi cấu hình, các máy chủ MCP hiện có của bạn trong roo code sẽ hoạt động liền mạch với mô hình Qwen 3.
Kiểm thử Qwen 3 với MCP: Truy vấn Cơ sở dữ liệu
Hãy kiểm thử Qwen 3 với thiết lập MCP của chúng ta bằng cách truy vấn cơ sở dữ liệu SQLite.
Chạy Script:
Với máy chủ SQLite MCP đang chạy (từ bước 1 trong phần “Cấu hình Qwen 3 với Máy chủ MCP”), thực thi script của bạn:
python qwen3_mcp_sqlite.py
Truy vấn mặc định (“Có bao nhiêu bảng trong cơ sở dữ liệu?”) sẽ trả về phản hồi cho biết có một bảng (example
), vì chúng ta đã tạo nó trước đó.
Kiểm thử Tương tác với Giao diện Web (Web UI):
Bỏ comment dòng gọi app_gui()
trong script và chạy lại:
if __name__ == '__main__':
# test()
app_gui()
Lệnh này khởi chạy một giao diện web dựa trên Gradio. Mở URL được cung cấp (thường là http://127.0.0.1:7860
) trong trình duyệt của bạn, nhập các truy vấn như “Liệt kê tất cả tên trong bảng example,” và Qwen 3 sẽ sử dụng máy chủ MCP để tìm nạp kết quả (ví dụ: “Alice, Bob”).
Hiểu Kết quả:
Ví dụ SQLite cho thấy cách Qwen 3 sử dụng MCP để tương tác với các công cụ bên ngoài. Mô hình gửi một truy vấn đến máy chủ MCP, máy chủ này thực thi nó trên test.db
và trả về kết quả. Thiết lập này hoàn hảo để xây dựng các tác nhân cần tìm nạp dữ liệu một cách động—khá mạnh mẽ, phải không?
Mẹo Sử dụng Qwen 3 với MCP Hiệu quả
- Giữ Truy vấn Đơn giản: Đối với các tác vụ cơ sở dữ liệu, sử dụng các lời nhắc rõ ràng như “Liệt kê tất cả tên trong bảng example” để nhận kết quả chính xác từ Qwen 3.
- Giám sát Sử dụng API: Dù sử dụng DashScope hay OpenRouter, hãy theo dõi việc sử dụng API của bạn để tránh đạt giới hạn tốc độ (rate limits).
- Khám phá Thêm Công cụ MCP: MCP hỗ trợ các công cụ như bộ nhớ và hệ thống tệp—kiểm tra GitHub của Qwen-Agent để xem thêm ví dụ.
- Kiểm thử Cục bộ Trước: Sử dụng giao diện web (web UI) để kiểm thử các truy vấn tương tác trước khi triển khai vào sản xuất.
Nhận xét của Tôi về Qwen 3 với MCP
Sau khi thử nghiệm với Qwen 3 và MCP, đây là những gì tôi nghĩ:
- Tích hợp Liền mạch: Thiết lập máy chủ MCP rất đơn giản, và Qwen 3 xử lý việc gọi công cụ một cách xuất sắc.
- Mạnh mẽ cho Tác nhân: Truy vấn cơ sở dữ liệu chỉ là khởi đầu—MCP mở ra khả năng vô tận cho quy trình làm việc của tác nhân.
- Tăng cường Hiệu suất: Các điểm chuẩn của Qwen 3 cho thấy nó là một đối thủ hàng đầu, và hỗ trợ MCP làm cho nó càng linh hoạt hơn.
Nếu bạn gặp bất kỳ trở ngại nào, hãy kiểm tra lại khóa API của bạn và đảm bảo máy chủ MCP đang chạy.
Kết thúc: Hành trình của Bạn với Qwen 3 và MCP
Bạn vừa mở khóa sức mạnh của Qwen 3 với hỗ trợ MCP, làm cho các tác nhân AI của bạn thông minh hơn và có khả năng hơn! Từ truy vấn cơ sở dữ liệu đến khám phá các công cụ MCP khác, bạn đã sẵn sàng xây dựng những điều tuyệt vời. Để biết thêm chi tiết, đừng ngần ngại kiểm tra kho lưu trữ Qwen-Agent GitHub hoặc qwen3.org. Tiếp tục phát triển với Qwen 3 và MCP!