1. Context7 là gì?
Context7 là một MCP server giúp lập trình viên và trợ lý AI truy xuất tài liệu chính xác theo phiên bản của thư viện/framework. Nhờ đó, code sinh ra từ AI hoặc hướng dẫn trong IDE sẽ luôn đúng với môi trường thực tế, tránh lỗi do dùng tài liệu cũ.
👉 Hãy hình dung Context7 như một "thư viện viên thông minh", luôn đưa bạn đúng quyển sách và đúng trang mà bạn cần.
2. Cách thức hoạt động
Luồng cơ bản
-
Bạn ra lệnh trong IDE/Assistant Ví dụ: "Tạo service Spring Boot, use context7, version 3.3.2"
-
IDE gọi Context7 qua MCP
- Gửi yêu cầu
resolve-library-idđể tìm đúng gói thư viện. - Sau đó gọi
get-library-docsđể lấy docs/snippet chính xác.
- Gửi yêu cầu
-
Context7 xử lý & trả về
- Truy vấn docs chính thức.
- Trả về snippet/code dạng JSON phù hợp với MCP.
-
IDE/Assistant hiển thị Snippet/docs xuất hiện trực tiếp trong hội thoại hoặc cửa sổ IDE.
3. Ví dụ minh họa
Ví dụ với Ansible (cấu hình server)
Inventory (servers.ini)
[web]
192.168.1.10
192.168.1.11
Playbook cài Nginx (install-nginx.yml)
- hosts: web
become: true
tasks:
- name: Cài đặt Nginx
apt:
name: nginx
state: present
Khi chạy với Ansible, bạn chỉ cần ansible-playbook -i servers.ini install-nginx.yml.
Ví dụ với React (xử lý code thực tế)
Bạn muốn tạo React component dùng React Hooks mới nhất. Trong IDE, gõ:
Tạo component React có form đăng nhập, **use context7**, React version 18.
👉 Context7 sẽ trả về docs & snippet chuẩn từ React 18:
import { useState } from 'react';
function LoginForm() {
const [username, setUsername] = useState('');
const [password, setPassword] = useState('');
const handleSubmit = (e) => {
e.preventDefault();
console.log({ username, password });
};
return (
<form onSubmit={handleSubmit}>
<input
type="text"
placeholder="Username"
value={username}
onChange={(e) => setUsername(e.target.value)}
/>
<input
type="password"
placeholder="Password"
value={password}
onChange={(e) => setPassword(e.target.value)}
/>
<button type="submit">Login</button>
</form>
);
}
export default LoginForm;
Nhờ Context7, code trên được sinh ra chuẩn theo React 18 API, không lẫn code cũ từ class component.
4. Lợi ích chính
- Đúng phiên bản → tránh bug do tài liệu cũ.
- Nhanh chóng → không cần tự lên docs tìm tay.
- Tích hợp liền mạch → hoạt động trực tiếp trong IDE/Assistant.
- Mở rộng dễ dàng → có thể kết hợp với MCP server nội bộ để truy xuất guideline, playbook riêng.
5. Kết luận
Context7 không chỉ là một công cụ hỗ trợ AI, mà còn là cầu nối tin cậy giữa lập trình viên và nguồn tri thức chính thống. Nhờ Context7, bạn có thể tự tin rằng đoạn code hoặc snippet AI sinh ra luôn đúng chuẩn, tiết kiệm thời gian debug và tăng tốc phát triển.
🚀 Hãy thử tích hợp Context7 ngay hôm nay để trải nghiệm coding chính xác và mượt mà hơn!
6. Case study chi tiết – Xử lý code React/Next.js
Mục tiêu
Xây dựng nhanh Todo App với React 18 + Next.js (App Router) + TanStack Query (React Query) có optimistic update, đảm bảo snippet luôn đúng phiên bản khi sinh bởi AI/IDE.
6.1. Prompt mẫu trong IDE (Cursor/Claude Desktop)
Sao chép prompt này vào IDE:
Hãy scaffold Todo App với Next.js (App Router). Use context7.
Version: react 18.x, next 14.x, @tanstack/react-query 5.x, typescript.
Tích hợp React Query, mutation optimistic update, và component phân tách Client/Server đúng chuẩn.
Khi IDE thấy “Use context7”, client sẽ gọi MCP server Context7 để lấy đúng docs/snippet theo phiên bản đã nêu.
6.2. Luồng gọi Context7 (tự động phía IDE)
resolve-library-idvới từ khóa:react,react-dom,next,@tanstack/react-query→ chọn đúng libraryId & version.get-library-docstheolibraryId + version + topics(ví dụ: app router, route handlers, client component, React Query mutations).- IDE lấy snippet chuẩn và chèn vào file.
6.3. Cấu trúc dự án (App Router)
app/
layout.tsx # Server component
page.tsx # Server component (landing)
todos/
page.tsx # Server component: list todos
components/
TodoList.tsx # Client component: hiển thị & thao tác
AddTodo.tsx # Client component: form thêm mới
lib/
queryClient.ts # Cấu hình React Query
api.ts # Hàm gọi API fetcher
app/api/todos/route.ts # Route handler (GET/POST)
6.4. Mã minh họa trọng tâm
lib/queryClient.ts
// tạo QueryClient dùng cho Client Components
import { QueryClient } from '@tanstack/react-query';
export const getQueryClient = (() => {
let client: QueryClient | null = null;
return () => (client ??= new QueryClient());
})();
lib/api.ts
export async function fetchJSON<T>(url: string, init?: RequestInit): Promise<T> {
const res = await fetch(url, { ...init, headers: { 'Content-Type': 'application/json' } });
if (!res.ok) throw new Error(await res.text());
return res.json();
}
app/api/todos/route.ts (Route Handlers)
import { NextResponse } from 'next/server';
let TODOS = [{ id: '1', title: 'Learn React', done: false }];
export async function GET() {
return NextResponse.json(TODOS);
}
export async function POST(req: Request) {
const body = await req.json();
const todo = { id: String(Date.now()), title: body.title, done: false };
TODOS = [todo, ...TODOS];
return NextResponse.json(todo, { status: 201 });
}
components/TodoList.tsx (Client Component + Optimistic Update)
'use client';
import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
import { fetchJSON } from '@/lib/api';
export default function TodoList() {
const qc = useQueryClient();
const { data: todos = [] } = useQuery({
queryKey: ['todos'],
queryFn: () => fetchJSON('/api/todos')
});
const addTodo = useMutation({
mutationFn: (title: string) => fetchJSON('/api/todos', {
method: 'POST',
body: JSON.stringify({ title })
}),
// Optimistic update
onMutate: async (title: string) => {
await qc.cancelQueries({ queryKey: ['todos'] });
const prev = qc.getQueryData<any[]>(['todos']) || [];
const optimistic = [{ id: 'optimistic', title, done: false }, ...prev];
qc.setQueryData(['todos'], optimistic);
return { prev };
},
onError: (_err, _vars, ctx) => {
if (ctx?.prev) qc.setQueryData(['todos'], ctx.prev);
},
onSuccess: () => qc.invalidateQueries({ queryKey: ['todos'] })
});
return (
<div className="space-y-2">
<form onSubmit={e => {
e.preventDefault();
const form = e.currentTarget as HTMLFormElement;
const input = form.elements.namedItem('title') as HTMLInputElement;
if (input.value.trim()) addTodo.mutate(input.value.trim());
input.value = '';
}} className="flex gap-2">
<input name="title" placeholder="New todo" className="border p-2 rounded" />
<button type="submit" className="px-3 py-2 border rounded">Add</button>
</form>
<ul className="list-disc pl-5">
{todos.map((t: any) => (
<li key={t.id}>{t.title}</li>
))}
</ul>
</div>
);
}
app/todos/page.tsx (Server Component sử dụng Client Component)
import TodoList from '@/components/TodoList';
export default function TodosPage() {
return (
<section className="max-w-xl mx-auto p-6">
<h1 className="text-2xl font-semibold mb-4">Todos</h1>
<TodoList />
</section>
);
}
6.5. Vì sao cần Context7 ở đây?
- Đúng API theo phiên bản: App Router, Route Handlers và React Query v5 có API khác các phiên bản trước. Context7 bảo đảm snippet/trích dẫn từ docs khớp phiên bản bạn chỉ định.
- Giảm lỗi “nhớ nửa mùa” của AI: Thay vì để AI suy đoán, IDE buộc lấy nguồn từ docs chính thức qua Context7.
- Nhanh on-board: Dev mới vào dự án chỉ cần prompt chuẩn + Context7 là làm đúng theo “best practice” hiện hành.
6.6. Checklist chất lượng khi làm với React
- Pin version trong prompt (react, next, react-query).
- Phân tách Server/Client components rõ ràng; chỉ thêm
'use client'khi cần state/hook. - fetch / cache: Trong App Router,
fetchmặc định có cache; cân nhắccache: 'no-store'cho API động. - Optimistic update: luôn
cancelQueries→setQueryData→ rollback onError →invalidateQueriesonSuccess. - TypeScript: thêm type trả về cho API để IDE hiểu đúng.
- ESLint/Prettier: giữ code style nhất quán; Context7 có thể trỏ tới rule docs tương ứng.
6.7. Sai lầm hay gặp & cách khắc phục bằng Context7
- Nhầm API giữa Next 12/13/14 → dùng
topics: ['app router','route handlers']khi gọi Context7 để ép đúng trang docs. - React Query v3 vs v5 (khác rõ ở config & mutation lifecycle) → chỉ rõ
@tanstack/react-query 5.xtrong prompt. - Dùng sai nơi
'use client'→ nhờ Context7 lôi đoạn docs giải thích khi nào cần Client Component.
7. Gợi ý mở rộng
- Storybook: nhờ Context7 lấy snippet cấu hình Storybook đúng version.
- Testing: tích hợp Playwright/Vitest; prompt yêu cầu test sample theo docs chính thức.
- CI: pipeline lint + typecheck + build; nếu bump version → dùng Context7 truy ngược breaking changes.