31 KiB
Context7 MCP - Documentação de Código Atualizada para Qualquer Prompt
❌ Sem o Context7
Os LLMs dependem de informações desatualizadas ou genéricas sobre as bibliotecas que você usa. Você obtém:
- ❌ Exemplos de código desatualizados e baseados em dados de treinamento de anos atrás
- ❌ APIs alucinadas que nem existem
- ❌ Respostas genéricas para versões antigas de pacotes
✅ Com o Context7
O Context7 MCP extrai documentação e exemplos de código atualizados e específicos para cada versão diretamente da fonte — e os coloca diretamente em seu prompt.
Adicione use context7 ao seu prompt no Cursor:
Create a basic Next.js project with app router. use context7
Create a script to delete the rows where the city is "" given PostgreSQL credentials. use context7
O Context7 busca exemplos de código e documentação atualizados diretamente para o contexto do seu LLM.
- 1️⃣ Escreva seu prompt naturalmente
- 2️⃣ Diga ao LLM
use context7 - 3️⃣ Obtenha respostas com código funcional
Sem alternar entre abas, sem APIs alucinadas que não existem, sem gerações de código desatualizadas.
📚 Adicionando Projetos
Confira nosso guia de adição de projetos para aprender como adicionar (ou atualizar) suas bibliotecas favoritas ao Context7.
🛠️ Instalação
Requisitos
- Node.js >= v18.0.0
- Cursor, Claude Code, VSCode, Windsurf ou outro Cliente MCP
Instalando via Smithery
Para instalar o Context7 MCP Server automaticamente em qualquer cliente via Smithery:
npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME> --key <YOUR_SMITHERY_KEY>
Você pode encontrar sua chave Smithery na página do Smithery.ai.
Instalar no Cursor
Vá em: Settings -> Cursor Settings -> MCP -> Add new global MCP server
Colar a seguinte configuração no arquivo ~/.cursor/mcp.json do Cursor é a abordagem recomendada. Você também pode instalar em um projeto específico criando .cursor/mcp.json na pasta do seu projeto. Veja mais em Cursor MCP docs.
Desde o Cursor 1.0, você pode clicar no botão de instalar abaixo para uma instalação instantânea com um clique.
Conexão Remota do Servidor Cursor
{
"mcpServers": {
"context7": {
"url": "https://mcp.context7.com/mcp"
}
}
}
Conexão Local do Servidor Cursor
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
Instalar no Claude Code
Execute este comando. Veja mais em Claude Code MCP docs.
Conexão Remota do Servidor Claude Code
claude mcp add --transport http context7 https://mcp.context7.com/mcp
Ou usando transporte SSE:
claude mcp add --transport sse context7 https://mcp.context7.com/sse
Conexão Local do Servidor Claude Code
claude mcp add context7 -- npx -y @upstash/context7-mcp
Instalar no Windsurf
Adicione isto ao arquivo de configuração MCP do Windsurf. Veja mais em Windsurf MCP docs.
Conexão Remota do Servidor Windsurf
{
"mcpServers": {
"context7": {
"serverUrl": "https://mcp.context7.com/mcp"
}
}
}
Conexão Local do Servidor Windsurf
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
Instalar no VS Code
Adicione isto ao arquivo de configuração MCP do VS Code. Veja mais em VS Code MCP docs.
Conexão Remota do Servidor VS Code
"mcp": {
"servers": {
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp"
}
}
}
Conexão Local do Servidor VS Code
"mcp": {
"servers": {
"context7": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
Instalar no Cline
Você pode instalar o Context7 facilmente pelo Cline MCP Server Marketplace seguindo estas instruções:
- Abra o Cline.
- Clique no ícone de menu (☰) para entrar na seção MCP Servers.
- Use a barra de busca na aba Marketplace para encontrar Context7.
- Clique no botão Install.
Instalar no Zed
Pode ser instalado via Zed Extensions ou você pode adicionar isto ao seu settings.json do Zed. Veja mais em Zed Context Server docs.
{
"context_servers": {
"Context7": {
"command": {
"path": "npx",
"args": ["-y", "@upstash/context7-mcp"]
},
"settings": {}
}
}
}
Instalar no Augment Code
Para configurar o Context7 MCP no Augment Code, você pode usar a interface gráfica ou a configuração manual.
A. Usando a UI do Augment Code
-
Clique no menu hambúrguer.
-
Selecione Settings.
-
Navegue até a seção Tools.
-
Clique no botão + Add MCP.
-
Insira o seguinte comando:
npx -y @upstash/context7-mcp@latest -
Nomeie o MCP: Context7.
-
Clique no botão Add.
Depois que o servidor MCP for adicionado, você pode começar a usar os recursos de documentação de código atualizada do Context7 diretamente no Augment Code.
B. Configuração Manual
- Pressione Cmd/Ctrl Shift P ou vá ao menu hambúrguer no painel do Augment
- Selecione Edit Settings
- Em Advanced, clique em Edit em settings.json
- Adicione a configuração do servidor ao array
mcpServersno objetoaugment.advanced
"augment.advanced": {
"mcpServers": [
{
"name": "context7",
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
]
}
Depois de adicionar o servidor MCP, reinicie seu editor. Se você receber algum erro, verifique a sintaxe para garantir que colchetes ou vírgulas não estejam faltando.
Instalar no Roo Code
Adicione isto ao arquivo de configuração MCP do Roo Code. Veja mais em Roo Code MCP docs.
Conexão Remota do Servidor Roo Code
{
"mcpServers": {
"context7": {
"type": "streamable-http",
"url": "https://mcp.context7.com/mcp"
}
}
}
Conexão Local do Servidor Roo Code
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
Instalar no Gemini CLI
Veja os detalhes em Configuração do Gemini CLI.
- Abra o arquivo de configurações do Gemini CLI. A localização é
~/.gemini/settings.json(onde~é o seu diretório home). - Adicione o seguinte ao objeto
mcpServersno seu arquivosettings.json:
{
"mcpServers": {
"context7": {
"httpUrl": "https://mcp.context7.com/mcp"
}
}
}
Ou, para um servidor local:
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
Se o objeto mcpServers não existir, crie-o.
Instalar no Claude Desktop
Conexão Remota
Abra o Claude Desktop e navegue até Settings > Connectors > Add Custom Connector. Insira o nome como Context7 e a URL remota do MCP server como https://mcp.context7.com/mcp.
Conexão Local
Abra as configurações de desenvolvedor do Claude Desktop e edite seu arquivo claude_desktop_config.json para adicionar a seguinte configuração. Veja mais em Claude Desktop MCP docs.
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
Instalar no Opencode
Adicione isto ao arquivo de configuração do Opencode. Veja mais em Opencode MCP docs.
Conexão Remota do Opencode
"mcp": {
"context7": {
"type": "remote",
"url": "https://mcp.context7.com/mcp",
"enabled": true
}
}
Conexão Local do Opencode
{
"mcp": {
"context7": {
"type": "local",
"command": ["npx", "-y", "@upstash/context7-mcp"],
"enabled": true
}
}
}
Instalar no OpenAI Codex
Veja mais em OpenAI Codex.
Adicione a seguinte configuração às definições do servidor MCP do OpenAI Codex:
[mcp_servers.context7]
args = ["-y", "@upstash/context7-mcp"]
command = "npx"
Instalar no JetBrains AI Assistant
Veja mais detalhes na Documentação do JetBrains AI Assistant.
- Nos IDEs da JetBrains vá em
Settings->Tools->AI Assistant->Model Context Protocol (MCP) - Clique em
+ Add. - Clique em
Commandno canto superior esquerdo do diálogo e selecione a opção As JSON na lista - Adicione esta configuração e clique em
OK
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
- Clique em
Applypara salvar as alterações. - Da mesma forma, o context7 pode ser adicionado ao JetBrains Junie em
Settings->Tools->Junie->MCP Settings
Instalar no Kiro
Veja a Documentação do Kiro Model Context Protocol para detalhes.
- Navegue até
Kiro>MCP Servers - Adicione um novo servidor MCP clicando no botão
+ Add. - Cole a configuração abaixo:
{
"mcpServers": {
"Context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"],
"env": {},
"disabled": false,
"autoApprove": []
}
}
}
- Clique em
Savepara aplicar as alterações.
Instalar no Trae
Use o recurso Add manually e preencha as informações de configuração JSON para esse servidor MCP. Para mais detalhes, visite a documentação do Trae.
Conexão Remota do Servidor Trae
{
"mcpServers": {
"context7": {
"url": "https://mcp.context7.com/mcp"
}
}
}
Conexão Local do Servidor Trae
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
Usando Bun ou Deno
Use estas alternativas para executar o servidor Context7 MCP local com outros runtimes. Esses exemplos funcionam para qualquer cliente que suporte iniciar um servidor MCP local via command + args.
Bun
{
"mcpServers": {
"context7": {
"command": "bunx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
Deno
{
"mcpServers": {
"context7": {
"command": "deno",
"args": [
"run",
"--allow-env=NO_DEPRECATION,TRACE_DEPRECATION",
"--allow-net",
"npm:@upstash/context7-mcp"
]
}
}
}
Usando Docker
Se preferir executar o servidor MCP em um contêiner Docker:
-
Crie a Imagem Docker:
Primeiro, crie um
Dockerfilena raiz do projeto (ou onde preferir):Clique para ver o conteúdo do Dockerfile
FROM node:18-alpine WORKDIR /app # Instalar a versão mais recente globalmente RUN npm install -g @upstash/context7-mcp # Expor porta padrão se necessário (opcional, depende da interação do cliente MCP) # EXPOSE 3000 # Comando padrão para rodar o servidor CMD ["context7-mcp"]Em seguida, construa a imagem usando uma tag (por exemplo,
context7-mcp). Certifique-se de que o Docker Desktop (ou o daemon Docker) esteja em execução. Execute o comando abaixo no mesmo diretório onde você salvou oDockerfile:docker build -t context7-mcp . -
Configure seu Cliente MCP:
Atualize a configuração do seu cliente MCP para usar o comando Docker.
Exemplo para um cline_mcp_settings.json:
{ "mcpServers": { "Сontext7": { "autoApprove": [], "disabled": false, "timeout": 60, "command": "docker", "args": ["run", "-i", "--rm", "context7-mcp"], "transportType": "stdio" } } }Nota: Este é um exemplo de configuração. Consulte os exemplos específicos do seu cliente MCP (como Cursor, VS Code, etc.) anteriormente neste README para adaptar a estrutura (por exemplo,
mcpServersvsservers). Além disso, garanta que o nome da imagem emargscorresponda à tag usada durante o comandodocker build.
Instalar Usando a Extensão Desktop
Instale o arquivo context7.dxt na pasta dxt e adicione-o ao seu cliente. Para mais informações, confira a documentação de desktop extensions.
Instalar no Windows
A configuração no Windows é um pouco diferente em comparação ao Linux ou macOS (Cline é usado no exemplo). O mesmo princípio se aplica a outros editores; consulte a configuração de command e args.
{
"mcpServers": {
"github.com/upstash/context7-mcp": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@upstash/context7-mcp"],
"disabled": false,
"autoApprove": []
}
}
}
Instalar no Amazon Q Developer CLI
Adicione isto ao arquivo de configuração do Amazon Q Developer CLI. Veja mais em documentação do Amazon Q Developer CLI.
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
Instalar no Warp
Veja mais em Documentação do Warp Model Context Protocol.
- Vá em
Settings>AI>Manage MCP servers. - Adicione um novo servidor MCP clicando no botão
+ Add. - Cole a configuração abaixo:
{
"Context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"],
"env": {},
"working_directory": null,
"start_on_launch": true
}
}
- Clique em
Savepara aplicar as alterações.
Instalar no Copilot Coding Agent
Usando o Context7 com o Copilot Coding Agent
Adicione a seguinte configuração à seção mcp do arquivo de configuração do seu Copilot Coding Agent Repository->Settings->Copilot->Coding agent->MCP configuration:
{
"mcpServers": {
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp",
"tools": ["get-library-docs", "resolve-library-id"]
}
}
}
Para mais informações, veja a documentação oficial do GitHub.
Instalar no LM Studio
Veja mais em Suporte a MCP no LM Studio.
Instalação com um clique:
Configuração manual:
- Navegue até
Program(lado direito) >Install>Edit mcp.json. - Cole a configuração abaixo:
{
"mcpServers": {
"Context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
- Clique em
Savepara aplicar as alterações. - Ative/desative o servidor MCP no lado direito, em
Program, ou clicando no ícone de plug na parte inferior da caixa de chat.
Instalar no Visual Studio 2022
Você pode configurar o Context7 MCP no Visual Studio 2022 seguindo a documentação de MCP Servers do Visual Studio.
Adicione isto ao arquivo de configuração MCP do Visual Studio (veja os docs do Visual Studio para detalhes):
{
"mcp": {
"servers": {
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp"
}
}
}
}
Ou, para um servidor local:
{
"mcp": {
"servers": {
"context7": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
}
Para mais informações e solução de problemas, consulte a documentação de MCP Servers do Visual Studio.
Instalar no Crush
Adicione isto ao arquivo de configuração do Crush. Veja mais em Crush MCP docs.
Conexão Remota do Crush (HTTP)
{
"$schema": "https://charm.land/crush.json",
"mcp": {
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp"
}
}
}
Conexão Remota do Crush (SSE)
{
"$schema": "https://charm.land/crush.json",
"mcp": {
"context7": {
"type": "sse",
"url": "https://mcp.context7.com/sse"
}
}
}
Conexão Local do Crush
{
"$schema": "https://charm.land/crush.json",
"mcp": {
"context7": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
Instalar no BoltAI
Abra a página "Settings" do app, navegue até "Plugins" e insira o seguinte JSON:
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
Depois de salvar, digite no chat get-library-docs seguido do seu Context7 documentation ID (por exemplo, get-library-docs /nuxt/ui). Mais informações em BoltAI's Documentation site. Para o BoltAI no iOS, veja este guia.
Instalar no Rovo Dev CLI
Edite sua configuração MCP do Rovo Dev CLI executando o comando abaixo -
acli rovodev mcp
Configuração de exemplo -
Conexão Remota
{
"mcpServers": {
"context7": {
"url": "https://mcp.context7.com/mcp"
}
}
}
Conexão Local
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
Instalar no Zencoder
Para configurar o Context7 MCP no Zencoder, siga estes passos:
- Vá ao menu do Zencoder (...)
- No menu suspenso, selecione Agent tools
- Clique em Add custom MCP
- Adicione o nome e a configuração do servidor abaixo e certifique-se de clicar no botão Install
{
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
Depois que o servidor MCP for adicionado, você pode continuar usando-o facilmente.
Instalar no Qodo Gen
Veja mais em docs do Qodo Gen.
- Abra o painel de chat do Qodo Gen no VSCode ou IntelliJ.
- Clique em Connect more tools.
- Clique em + Add new MCP.
- Adicione a seguinte configuração:
Conexão Local do Qodo Gen
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
Conexão Remota do Qodo Gen
{
"mcpServers": {
"context7": {
"url": "https://mcp.context7.com/mcp"
}
}
}
Instalar no Perplexity Desktop
Veja mais em Local and Remote MCPs for Perplexity.
- Vá em
Perplexity>Settings - Selecione
Connectors. - Clique em
Add Connector. - Selecione
Advanced. - Insira Server Name:
Context7 - Cole o seguinte JSON na área de texto:
{
"args": ["-y", "@upstash/context7-mcp"],
"command": "npx",
"env": {}
}
- Clique em
Save.
🔨 Ferramentas Disponíveis
O Context7 MCP fornece as seguintes ferramentas que LLMs podem usar:
-
resolve-library-id: Resolve um nome geral de biblioteca em um ID compatível com o Context7.libraryName(obrigatório): O nome da biblioteca a ser pesquisada
-
get-library-docs: Busca documentação para uma biblioteca usando um ID compatível com o Context7.context7CompatibleLibraryID(obrigatório): ID exato compatível com Context7 (por exemplo,/mongodb/docs,/vercel/next.js)topic(opcional): Focar os docs em um tópico específico (por exemplo, "routing", "hooks")tokens(opcional, padrão 10000): Número máximo de tokens para retornar. Valores menores que o padrão de 10000 são automaticamente aumentados para 10000.
🛟 Dicas
Adicionar uma Regra
Se você não quiser adicionar
use context7a todo prompt, você pode definir uma regra simples no seu arquivo.windsurfrulesno Windsurf ou emCursor Settings > Rulesno Cursor (ou equivalente no seu cliente MCP) para invocar o Context7 automaticamente em qualquer questão de código:[[calls]] match = "quando o usuário solicitar exemplos de código, passos de configuração ou documentação de biblioteca/API" tool = "context7"A partir daí você receberá os docs do Context7 em qualquer conversa relacionada sem digitar nada extra. Você pode adicionar seus casos de uso na parte match.
Usar o ID da Biblioteca
Se você já sabe exatamente qual biblioteca deseja usar, adicione o ID do Context7 ao seu prompt. Assim, o servidor MCP do Context7 pode pular a etapa de correspondência de biblioteca e ir direto para recuperar os docs.
implementar autenticação básica com supabase. use library /supabase/supabase para api e docsA sintaxe com barra informa à ferramenta MCP exatamente qual biblioteca carregar.
💻 Desenvolvimento
Clone o projeto e instale as dependências:
bun i
Build:
bun run build
Execute o servidor:
bun run dist/index.js
Argumentos de CLI
context7-mcp aceita as seguintes flags de CLI:
--transport <stdio|http>– Transporte a ser usado (stdiopor padrão). Observe que o transporte HTTP fornece automaticamente endpoints HTTP e SSE.--port <number>– Porta para escutar ao usar o transportehttp(padrão3000).
Exemplo com transporte http e porta 8080:
bun run dist/index.js --transport http --port 8080
Outro exemplo com transporte stdio:
bun run dist/index.js --transport stdio
Exemplo de Configuração Local
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["tsx", "/path/to/folder/context7-mcp/src/index.ts"]
}
}
}
Testando com o MCP Inspector
npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp
🚨 Solução de Problemas
Erros de Módulo Não Encontrado
Se você encontrar ERR_MODULE_NOT_FOUND, tente usar bunx em vez de npx:
{
"mcpServers": {
"context7": {
"command": "bunx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
Isso frequentemente resolve problemas de resolução de módulos em ambientes onde o npx não instala ou resolve os pacotes corretamente.
Problemas de Resolução ESM
Para erros como Error: Cannot find module 'uriTemplate.js', tente a flag --experimental-vm-modules:
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "--node-options=--experimental-vm-modules", "@upstash/context7-mcp@1.0.6"]
}
}
}
Problemas de TLS/Certificados
Use a flag --experimental-fetch para contornar problemas relacionados a TLS:
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "--node-options=--experimental-fetch", "@upstash/context7-mcp"]
}
}
}
Erros Gerais do Cliente MCP
- Tente adicionar
@latestao nome do pacote - Use
bunxcomo alternativa aonpx - Considere usar
denocomo outra alternativa - Certifique-se de estar usando Node.js v18 ou superior para suporte nativo a fetch
⚠️ Aviso
Os projetos do Context7 são contribuídos pela comunidade e, embora nos esforcemos para manter alta qualidade, não podemos garantir a precisão, integridade ou segurança de toda a documentação de bibliotecas. Os projetos listados no Context7 são desenvolvidos e mantidos por seus respectivos proprietários, não pelo Context7. Se você encontrar qualquer conteúdo suspeito, impróprio ou potencialmente prejudicial, use o botão "Report" na página do projeto para nos notificar imediatamente. Levamos todos os relatos a sério e revisaremos o conteúdo sinalizado prontamente para manter a integridade e a segurança de nossa plataforma. Ao usar o Context7, você reconhece que o faz por sua própria conta e risco.
🤝 Conecte-se Conosco
Mantenha-se atualizado e junte-se à nossa comunidade:
- 📢 Siga-nos no X para as últimas notícias e atualizações
- 🌐 Visite nosso Website
- 💬 Junte-se ao nosso Discord Community
📺 Context7 na Mídia
- Better Stack: "Free Tool Makes Cursor 10x Smarter"
- Cole Medin: "This is Hands Down the BEST MCP Server for AI Coding Assistants"
- Income Stream Surfers: "Context7 + SequentialThinking MCPs: Is This AGI?"
- Julian Goldie SEO: "Context7: New MCP AI Agent Update"
- JeredBlu: "Context 7 MCP: Get Documentation Instantly + VS Code Setup"
- Income Stream Surfers: "Context7: The New MCP Server That Will CHANGE AI Coding"
- AICodeKing: "Context7 + Cline & RooCode: This MCP Server Makes CLINE 100X MORE EFFECTIVE!"
- Sean Kochel: "5 MCP Servers For Vibe Coding Glory (Just Plug-In & Go)"
⭐ Histórico de Stars
📄 Licença
MIT