Skip to content

Latest commit

 

History

History
338 lines (243 loc) · 11.2 KB

README.pt-BR.md

File metadata and controls

338 lines (243 loc) · 11.2 KB

Context7 MCP - Documentação Atualizada Para Qualquer Prompt

Website smithery badge Instalar no VS Code (npx)

中文文档 한국어 문서 Documentación en Español Documentation en Français

❌ 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 para 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.

🛠️ Primeiros Passos

Requisitos

  • Node.js >= v18.0.0
  • Cursor, Windsurf, Claude Desktop ou outro Cliente MCP

Instalando via Smithery

Para instalar o Servidor Context7 MCP para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @upstash/context7-mcp --client claude

Instalar no Cursor

Vá para: Settings -> Cursor Settings -> MCP -> Add new global MCP server

Colar a seguinte configuração no seu arquivo Cursor ~/.cursor/mcp.json é a abordagem recomendada. Veja a documentação do Cursor MCP para mais informações.

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}
Alternativa: Usar Bun
{
  "mcpServers": {
    "context7": {
      "command": "bunx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}
Alternativa: Usar Deno
{
  "mcpServers": {
    "context7": {
      "command": "deno",
      "args": ["run", "--allow-net", "npm:@upstash/context7-mcp"]
    }
  }
}

Instalar no Windsurf

Adicione isto ao seu arquivo de configuração MCP do Windsurf. Veja a documentação do Windsurf MCP para mais informações.

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

Instalar no VS Code

Instalar no VS Code (npx) Instalar no VS Code Insiders (npx)

Adicione isto ao seu arquivo de configuração MCP do VS Code. Veja a documentação do VS Code MCP para mais informações.

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

Instalar no Zed

Pode ser instalado via Extensões do Zed ou você pode adicionar isto ao seu settings.json do Zed. Veja a documentação de Servidores de Contexto do Zed para mais informações.

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

Instalar no Claude Code

Execute este comando. Veja a documentação do Claude Code MCP para mais informações.

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

Instalar no Claude Desktop

Adicione isto ao seu arquivo claude_desktop_config.json do Claude Desktop. Veja a documentação do Claude Desktop MCP para mais informações.

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

Usando Docker

Se você preferir executar o servidor MCP em um contêiner Docker:

  1. Construa a Imagem Docker:

    Primeiro, crie um Dockerfile na raiz do projeto (ou onde preferir):

    Clique para ver o conteúdo do Dockerfile
    FROM node:18-alpine
    
    WORKDIR /app
    
    # Instala a versão mais recente globalmente
    RUN npm install -g @upstash/context7-mcp@latest
    
    # Expõe a porta padrão se necessário (opcional, depende da interação do cliente MCP)
    # EXPOSE 3000
    
    # Comando padrão para executar 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 do Docker) esteja em execução. Execute o seguinte comando no mesmo diretório onde você salvou o Dockerfile:

    docker build -t context7-mcp .
  2. 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 para o seu cliente MCP (como Cursor, VS Code, etc.) mencionados anteriormente neste README para adaptar a estrutura (por exemplo, mcpServers vs servers). Além disso, certifique-se de que o nome da imagem em args corresponda à tag usada durante o comando docker build.

Ferramentas Disponíveis

  • resolve-library-id: Resolve um nome geral de biblioteca em um ID de biblioteca compatível com Context7.
    • libraryName (obrigatório)
  • get-library-docs: Busca documentação para uma biblioteca usando um ID de biblioteca compatível com Context7.
    • context7CompatibleLibraryID (obrigatório)
    • topic (opcional): Concentra a documentação em um tópico específico (por exemplo, "routing", "hooks")
    • tokens (opcional, padrão 5000): Número máximo de tokens a retornar. Valores menores que 5000 são automaticamente aumentados para 5000.

Desenvolvimento

Clone o projeto e instale as dependências:

bun i

Compilação:

bun run build

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@latest

Solução de Problemas

ERR_MODULE_NOT_FOUND

Se você vir este erro, tente usar bunx em vez de npx.

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

Isso geralmente resolve problemas de resolução de módulos, especialmente em ambientes onde o npx não instala ou resolve pacotes adequadamente.

Problemas de Resolução ESM

Se você encontrar um erro como: Error: Cannot find module 'uriTemplate.js' tente executar com a flag --experimental-vm-modules:

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

Erros do Cliente MCP

  1. Tente remover @latest do nome do pacote.

  2. Tente usar bunx como alternativa.

  3. Tente usar deno como alternativa.

  4. Certifique-se de estar usando o Node v18 ou superior para ter suporte nativo ao fetch com npx.

Aviso Legal

Os projetos Context7 são contribuições da comunidade e, embora nos esforcemos para manter alta qualidade, não podemos garantir a precisão, completude ou segurança de toda a documentação da biblioteca. 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, inadequado ou potencialmente prejudicial, use o botão "Report" na página do projeto para nos notificar imediatamente. Levamos todos os relatórios a sério e revisaremos o conteúdo sinalizado prontamente para manter a integridade e segurança de nossa plataforma. Ao usar o Context7, você reconhece que o faz por sua própria conta e risco.

Context7 na Mídia

Histórico de Estrelas

Star History Chart

Licença

MIT