yujunjun/context7

Fork 0

mirror of https://github.com/upstash/context7.git synced 2025-11-14 17:13:41 +00:00

enesgules 76bf5ac85a chore: update dev deps and reformat docs

2025-09-02 14:55:08 +03:00

30 KiB

Raw Blame History

Context7 MCP - Tài Liệu Code Cập Nhật Cho Mọi Prompt

❌ Không có Context7

Các LLM dựa vào thông tin lỗi thời hoặc chung chung về các thư viện bạn sử dụng. Bạn sẽ gặp phải:

❌ Các ví dụ code lỗi thời và dựa trên dữ liệu huấn luyện cũ
❌ API được tạo ra không tồn tại thực sự
❌ Câu trả lời chung chung cho các phiên bản package cũ

✅ Với Context7

Context7 MCP lấy tài liệu và ví dụ code cập nhật, dành cho phiên bản cụ thể trực tiếp từ nguồn gốc — và đặt chúng trực tiếp vào prompt của bạn.

Thêm use context7 vào prompt của bạn trong Cursor:

Tạo một Next.js middleware kiểm tra JWT hợp lệ trong cookies và chuyển hướng người dùng chưa xác thực đến `/login`. use context7

Cấu hình script Cloudflare Worker để cache JSON API responses trong năm phút. use context7

Context7 lấy các ví dụ code và tài liệu cập nhật ngay vào context của LLM.

1️⃣ Viết prompt một cách tự nhiên
2️⃣ Nói với LLM để use context7
3️⃣ Nhận được câu trả lời code hoạt động

Không cần chuyển tab, không có API tự tạo không tồn tại, không có code generation lỗi thời.

📚 Thêm Dự Án

Xem hướng dẫn thêm dự án để học cách thêm (hoặc cập nhật) các thư viện yêu thích của bạn vào Context7.

🛠️ Cài Đặt

Yêu Cầu

Node.js >= v18.0.0
Cursor, Windsurf, Claude Desktop hoặc MCP Client khác

Cài đặt qua Smithery

Để cài đặt Context7 MCP Server cho bất kỳ client nào tự động qua Smithery:

npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME> --key <YOUR_SMITHERY_KEY>

Bạn có thể tìm Smithery key của mình tại trang web Smithery.ai.

Cài đặt trong Cursor

Đi đến: Settings -> Cursor Settings -> MCP -> Add new global MCP server

Paste cấu hình sau vào file Cursor ~/.cursor/mcp.json là cách được khuyến nghị. Bạn cũng có thể cài đặt trong một dự án cụ thể bằng cách tạo .cursor/mcp.json trong thư mục dự án. Xem tài liệu Cursor MCP để biết thêm thông tin.

Từ Cursor 1.0, bạn có thể click nút cài đặt bên dưới để cài đặt một cú click ngay lập tức.

Kết nối Cursor Remote Server

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Kết nối Cursor Local Server

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Thay thế: Sử dụng Bun

{
  "mcpServers": {
    "context7": {
      "command": "bunx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Thay thế: Sử dụng Deno

{
  "mcpServers": {
    "context7": {
      "command": "deno",
      "args": [
        "run",
        "--allow-env=NO_DEPRECATION,TRACE_DEPRECATION",
        "--allow-net",
        "npm:@upstash/context7-mcp"
      ]
    }
  }
}

Cài đặt trong Windsurf

Thêm cấu hình này vào file cấu hình Windsurf MCP của bạn. Xem tài liệu Windsurf MCP để biết thêm thông tin.

Kết nối Windsurf Remote Server

{
  "mcpServers": {
    "context7": {
      "serverUrl": "https://mcp.context7.com/sse"
    }
  }
}

Kết nối Windsurf Local Server

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Cài đặt trong Trae

Sử dụng tính năng Add manually và điền thông tin cấu hình JSON cho MCP server đó. Để biết thêm chi tiết, truy cập tài liệu Trae.

Kết nối Trae Remote Server

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Kết nối Trae Local Server

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Cài đặt trong VS Code

Thêm cấu hình này vào file cấu hình VS Code MCP của bạn. Xem tài liệu VS Code MCP để biết thêm thông tin.

Kết nối VS Code Remote Server

"mcp": {
  "servers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Kết nối VS Code Local Server

"mcp": {
  "servers": {
    "context7": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Cài đặt trong Visual Studio 2022

Bạn có thể cấu hình Context7 MCP trong Visual Studio 2022 bằng cách làm theo tài liệu Visual Studio MCP Servers.

Thêm cấu hình này vào file cấu hình Visual Studio MCP của bạn (xem tài liệu Visual Studio để biết chi tiết):

{
  "mcp": {
    "servers": {
      "context7": {
        "type": "http",
        "url": "https://mcp.context7.com/mcp"
      }
    }
  }
}

Hoặc, cho local server:

{
  "mcp": {
    "servers": {
      "context7": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@upstash/context7-mcp"]
      }
    }
  }
}

Để biết thêm thông tin và khắc phục sự cố, tham khảo tài liệu Visual Studio MCP Servers.

Cài đặt trong Zed

Có thể cài đặt thông qua Zed Extensions hoặc bạn có thể thêm cấu hình này vào settings.json của Zed. Xem tài liệu Zed Context Server để biết thêm thông tin.

{
  "context_servers": {
    "Context7": {
      "command": {
        "path": "npx",
        "args": ["-y", "@upstash/context7-mcp"]
      },
      "settings": {}
    }
  }
}

Cài đặt trong Gemini CLI

Xem Cấu hình Gemini CLI để biết chi tiết.

Mở file cài đặt Gemini CLI. Vị trí là ~/.gemini/settings.json (trong đó ~ là thư mục home của bạn).
Thêm cấu hình sau vào object mcpServers trong file settings.json của bạn:

{
  "mcpServers": {
    "context7": {
      "httpUrl": "https://mcp.context7.com/mcp"
    }
  }
}

Hoặc, cho local server:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Nếu object mcpServers không tồn tại, hãy tạo nó.

Cài đặt trong Claude Code

Chạy lệnh này. Xem tài liệu Claude Code MCP để biết thêm thông tin.

Kết nối Claude Code Remote Server

claude mcp add --transport http context7 https://mcp.context7.com/mcp

Hoặc sử dụng SSE transport:

claude mcp add --transport sse context7 https://mcp.context7.com/sse

Kết nối Claude Code Local Server

claude mcp add context7 -- npx -y @upstash/context7-mcp

Cài đặt trong Claude Desktop

Thêm cấu hình này vào file claude_desktop_config.json của Claude Desktop. Xem tài liệu Claude Desktop MCP để biết thêm thông tin.

{
  "mcpServers": {
    "Context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Cài đặt trong Cline

Bạn có thể dễ dàng cài đặt Context7 thông qua Cline MCP Server Marketplace bằng cách làm theo các hướng dẫn này:

Mở Cline.
Click biểu tượng menu hamburger (☰) để vào phần MCP Servers.
Sử dụng thanh tìm kiếm trong tab Marketplace để tìm Context7.
Click nút Install.

Cài đặt trong BoltAI

Mở trang "Settings" của ứng dụng, điều hướng đến "Plugins," và nhập JSON sau:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Sau khi lưu, nhập trong chat get-library-docs theo sau bởi Context7 documentation ID của bạn (ví dụ: get-library-docs /nuxt/ui). Thêm thông tin có sẵn tại trang Tài liệu BoltAI. Cho BoltAI trên iOS, xem hướng dẫn này.

Sử dụng Docker

Nếu bạn muốn chạy MCP server trong Docker container:

Build Docker Image:

Đầu tiên, tạo Dockerfile trong thư mục gốc dự án (hoặc bất cứ đâu bạn thích):
Click để xem nội dung Dockerfile
```
FROM node:18-alpine

WORKDIR /app

# Cài đặt phiên bản mới nhất globally
RUN npm install -g @upstash/context7-mcp

# Expose default port nếu cần (tùy chọn, phụ thuộc vào tương tác MCP client)
# EXPOSE 3000

# Lệnh mặc định để chạy server
CMD ["context7-mcp"]
```
Sau đó, build image sử dụng tag (ví dụ: context7-mcp). Đảm bảo Docker Desktop (hoặc Docker daemon) đang chạy. Chạy lệnh sau trong cùng thư mục nơi bạn lưu Dockerfile:
```
docker build -t context7-mcp .
```
Cấu hình MCP Client của bạn:

Cập nhật cấu hình MCP client của bạn để sử dụng lệnh Docker.

Ví dụ cho cline_mcp_settings.json:
```
{
  "mcpServers": {
    "Сontext7": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "command": "docker",
      "args": ["run", "-i", "--rm", "context7-mcp"],
      "transportType": "stdio"
    }
  }
}
```
Lưu ý: Đây là một ví dụ cấu hình. Vui lòng tham khảo các ví dụ cụ thể cho MCP client của bạn (như Cursor, VS Code, v.v.) ở phần trước trong README này để điều chỉnh cấu trúc (ví dụ: mcpServers vs servers). Ngoài ra, đảm bảo tên image trong args khớp với tag được sử dụng trong lệnh docker build.

Cài đặt trong Windows

Cấu hình trên Windows hơi khác so với Linux hoặc macOS (Cline được sử dụng trong ví dụ). Nguyên tắc tương tự áp dụng cho các editor khác; tham khảo cấu hình của command và args.

{
  "mcpServers": {
    "github.com/upstash/context7-mcp": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@upstash/context7-mcp@latest"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Cài đặt trong Augment Code

Để cấu hình Context7 MCP trong Augment Code, bạn có thể sử dụng giao diện đồ họa hoặc cấu hình thủ công.

A. Sử dụng Augment Code UI

Click menu hamburger.
Chọn Settings.
Điều hướng đến phần Tools.
Click nút + Add MCP.
Nhập lệnh sau:
```
npx -y @upstash/context7-mcp@latest
```
Đặt tên MCP: Context7.
Click nút Add.

Sau khi MCP server được thêm, bạn có thể bắt đầu sử dụng các tính năng tài liệu code cập nhật của Context7 trực tiếp trong Augment Code.

B. Cấu hình Thủ công

Nhấn Cmd/Ctrl Shift P hoặc đi đến menu hamburger trong panel Augment
Chọn Edit Settings
Trong Advanced, click Edit in settings.json
Thêm cấu hình server vào mảng mcpServers trong object augment.advanced

"augment.advanced": { "mcpServers": [ { "name": "context7", "command": "npx", "args": ["-y", "@upstash/context7-mcp"] } ] }

Sau khi MCP server được thêm, khởi động lại editor của bạn. Nếu bạn nhận được bất kỳ lỗi nào, kiểm tra cú pháp để đảm bảo không thiếu dấu ngoặc đóng hoặc dấu phẩy.

Cài đặt trong Roo Code

Thêm cấu hình này vào file cấu hình Roo Code MCP của bạn. Xem tài liệu Roo Code MCP để biết thêm thông tin.

Kết nối Roo Code Remote Server

{
  "mcpServers": {
    "context7": {
      "type": "streamable-http",
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Kết nối Roo Code Local Server

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Cài đặt trong Zencoder

Để cấu hình Context7 MCP trong Zencoder, làm theo các bước sau:

Đi đến menu Zencoder (...)
Từ menu dropdown, chọn Agent tools
Click vào Add custom MCP
Thêm tên và cấu hình server từ bên dưới, và đảm bảo nhấn nút Install

{
  "command": "npx",
  "args": ["-y", "@upstash/context7-mcp@latest"]
}

Sau khi MCP server được thêm, bạn có thể dễ dàng tiếp tục sử dụng nó.

Cài đặt trong Amazon Q Developer CLI

Thêm cấu hình này vào file cấu hình Amazon Q Developer CLI của bạn. Xem tài liệu Amazon Q Developer CLI để biết thêm chi tiết.

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

Cài đặt trong Qodo Gen

Xem tài liệu Qodo Gen để biết thêm chi tiết.

Mở panel chat Qodo Gen trong VSCode hoặc IntelliJ.
Click Connect more tools.
Click + Add new MCP.
Thêm cấu hình sau:

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Cài đặt trong JetBrains AI Assistant

Xem Tài liệu JetBrains AI Assistant để biết thêm chi tiết.

Trong JetBrains IDEs đi đến Settings -> Tools -> AI Assistant -> Model Context Protocol (MCP)
Click + Add.
Click vào Command ở góc trên bên trái của dialog và chọn tùy chọn As JSON từ danh sách
Thêm cấu hình này và click OK

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Click Apply để lưu thay đổi.
Theo cách tương tự, context7 có thể được thêm cho JetBrains Junie trong Settings -> Tools -> Junie -> MCP Settings

Cài đặt trong Warp

Xem Tài liệu Warp Model Context Protocol để biết chi tiết.

Điều hướng Settings > AI > Manage MCP servers.
Thêm MCP server mới bằng cách click nút + Add.
Paste cấu hình được cung cấp bên dưới:

{
  "Context7": {
    "command": "npx",
    "args": ["-y", "@upstash/context7-mcp"],
    "env": {},
    "working_directory": null,
    "start_on_launch": true
  }
}

Click Save để áp dụng thay đổi.

Cài đặt trong Opencode

Thêm cấu hình này vào file cấu hình Opencode của bạn. Xem tài liệu Opencode MCP để biết thêm thông tin.

Kết nối Opencode Remote Server

"mcp": {
  "context7": {
    "type": "remote",
    "url": "https://mcp.context7.com/mcp",
    "enabled": true
  }
}

Kết nối Opencode Local Server

{
  "mcp": {
    "context7": {
      "type": "local",
      "command": ["npx", "-y", "@upstash/context7-mcp"],
      "enabled": true
    }
  }
}

Cài đặt trong Copilot Coding Agent

Sử dụng Context7 với Copilot Coding Agent

Thêm cấu hình sau vào phần mcp trong file cấu hình Copilot Coding Agent của bạn Repository->Settings->Copilot->Coding agent->MCP configuration:

{
  "mcpServers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "tools": ["get-library-docs", "resolve-library-id"]
    }
  }
}

Để biết thêm thông tin, xem tài liệu GitHub chính thức.

Cài đặt trong Kiro

Xem Tài liệu Kiro Model Context Protocol để biết chi tiết.

Điều hướng Kiro > MCP Servers
Thêm MCP server mới bằng cách click nút + Add.
Paste cấu hình được cung cấp bên dưới:

{
  "mcpServers": {
    "Context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

Click Save để áp dụng thay đổi.

Cài đặt trong OpenAI Codex

Xem OpenAI Codex để biết thêm thông tin.

Thêm cấu hình sau vào cài đặt OpenAI Codex MCP server của bạn:

[mcp_servers.context7]
args = ["-y", "@upstash/context7-mcp"]
command = "npx"

Cài đặt trong LM Studio

Xem LM Studio MCP Support để biết thêm thông tin.

Cài đặt một cú click:

Thiết lập thủ công:

Điều hướng đến Program (bên phải) > Install > Edit mcp.json.
Paste cấu hình được cung cấp bên dưới:

{
  "mcpServers": {
    "Context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Click Save để áp dụng thay đổi.
Bật/tắt MCP server từ bên phải, dưới Program, hoặc bằng cách click biểu tượng plug ở cuối hộp chat.

🔨 Công Cụ Có Sẵn

Context7 MCP cung cấp các công cụ sau mà LLM có thể sử dụng:

resolve-library-id: Chuyển đổi tên thư viện chung thành Context7-compatible library ID.
- libraryName (bắt buộc): Tên của thư viện cần tìm kiếm
get-library-docs: Lấy tài liệu cho thư viện sử dụng Context7-compatible library ID.
- context7CompatibleLibraryID (bắt buộc): Context7-compatible library ID chính xác (ví dụ: /mongodb/docs, /vercel/next.js)
- topic (tùy chọn): Tập trung tài liệu vào một chủ đề cụ thể (ví dụ: "routing", "hooks")
- tokens (tùy chọn, mặc định 10000): Số token tối đa để trả về. Giá trị nhỏ hơn giá trị mặc định 10000 sẽ tự động tăng lên 10000.

🛟 Mẹo

Thêm Quy Tắc

Nếu bạn không muốn thêm use context7 vào mỗi prompt, bạn có thể định nghĩa một quy tắc đơn giản trong file .windsurfrules của bạn trong Windsurf hoặc từ phần Cursor Settings > Rules trong Cursor (hoặc tương đương trong MCP client của bạn) để tự động gọi Context7 trên bất kỳ câu hỏi code nào:
[[calls]]
match = "when the user requests code examples, setup or configuration steps, or library/API documentation"
tool  = "context7"
Từ đó bạn sẽ nhận được tài liệu Context7 trong bất kỳ cuộc hội thoại liên quan nào mà không cần gõ thêm gì. Bạn có thể thêm các trường hợp sử dụng của mình vào phần match.

Sử dụng Library Id

Nếu bạn đã biết chính xác thư viện nào muốn sử dụng, hãy thêm Context7 ID của nó vào prompt của bạn. Cách đó, Context7 MCP server có thể bỏ qua bước matching thư viện và trực tiếp tiếp tục với việc lấy tài liệu.
implement basic authentication with supabase. use library /supabase/supabase for api and docs
Cú pháp dấu gạch chéo nói với MCP tool chính xác thư viện nào cần load tài liệu.

💻 Phát Triển

Clone dự án và cài đặt dependencies:

bun i

Build:

bun run build

Chạy server:

bun run dist/index.js

Tham Số CLI

context7-mcp chấp nhận các CLI flags sau:

--transport <stdio|http|sse> – Transport để sử dụng (stdio theo mặc định).
--port <number> – Port để lắng nghe khi sử dụng transport http hoặc sse (mặc định 3000).

Ví dụ với http transport và port 8080:

bun run dist/index.js --transport http --port 8080

Ví dụ Cấu hình Local

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["tsx", "/path/to/folder/context7-mcp/src/index.ts"]
    }
  }
}

Test với MCP Inspector

npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp

🚨 Khắc Phục Sự Cố

Lỗi Module Not Found

Nếu bạn gặp ERR_MODULE_NOT_FOUND, thử sử dụng bunx thay vì npx:

{
  "mcpServers": {
    "context7": {
      "command": "bunx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Điều này thường giải quyết các vấn đề phân giải module trong môi trường mà npx không cài đặt hoặc phân giải packages đúng cách.

Vấn đề ESM Resolution

Đối với lỗi như Error: Cannot find module 'uriTemplate.js', thử flag --experimental-vm-modules:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "--node-options=--experimental-vm-modules", "@upstash/context7-mcp@1.0.6"]
    }
  }
}

Vấn đề TLS/Certificate

Sử dụng flag --experimental-fetch để vượt qua các vấn đề liên quan đến TLS:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "--node-options=--experimental-fetch", "@upstash/context7-mcp"]
    }
  }
}

Lỗi MCP Client Chung

Thử thêm @latest vào tên package
Sử dụng bunx như một thay thế cho npx
Cân nhắc sử dụng deno như một thay thế khác
Đảm bảo bạn đang sử dụng Node.js v18 trở lên để hỗ trợ native fetch

⚠️ Tuyên Bố Miễn Trừ Trách Nhiệm

Các dự án Context7 được đóng góp bởi cộng đồng và mặc dù chúng tôi cố gắng duy trì chất lượng cao, chúng tôi không thể đảm bảo tính chính xác, đầy đủ hoặc bảo mật của tất cả tài liệu thư viện. Các dự án được liệt kê trong Context7 được phát triển và duy trì bởi các chủ sở hữu tương ứng của họ, không phải bởi Context7. Nếu bạn gặp bất kỳ nội dung đáng ngờ, không phù hợp hoặc có khả năng gây hại nào, vui lòng sử dụng nút "Report" trên trang dự án để thông báo cho chúng tôi ngay lập tức. Chúng tôi xem xét tất cả các báo cáo một cách nghiêm túc và sẽ xem xét nội dung được gắn cờ kịp thời để duy trì tính toàn vẹn và an toàn của nền tảng. Bằng cách sử dụng Context7, bạn thừa nhận rằng bạn làm như vậy theo quyết định và rủi ro của riêng mình.

🤝 Kết Nối Với Chúng Tôi

Cập nhật và tham gia cộng đồng của chúng tôi:

📢 Theo dõi chúng tôi trên X để có tin tức và cập nhật mới nhất
🌐 Truy cập Website của chúng tôi
💬 Tham gia Discord Community của chúng tôi

📺 Context7 Trên Truyền Thông

⭐ Lịch Sử Star

📄 Giấy Phép

MIT

30 KiB Raw Blame History Unescape Escape