Sobre o projeto
A plataforma Context7 fornece documentação de código fresca e específica de versão, além de exemplos, de bibliotecas open-source diretamente nos contextos de LLMs.
Opera por meio de um servidor MCP ou um CLI com habilidades, funcionando com assistentes de codificação com IA como Cursor, Claude Code e OpenCode.
Sem o Context7, os LLMs dependem de dados de treinamento desatualizados, produzindo exemplos de código obsoletos, APIs alucinadas e respostas genéricas para versões antigas de pacotes. O Context7 resolve isso buscando documentação atualizada dos repositórios de origem na exata versão da biblioteca solicitada.
A instalação é feita via `npx ctx7 setup`, que guia a autenticação OAuth, gera uma chave de API (tier gratuito disponível em context7.com/dashboard) e instala tanto habilidades de CLI quanto um servidor MCP. Os usuários podem direcionar agentes específicos com flags como `--cursor`, `--claude` ou `--opencode`. Para remover a configuração posteriormente, execute `npx ctx7 remove`.
Principais funcionalidades incluem:
- **Suporte a Library ID**: Prefixar um Library ID conhecido (ex.: `/supabase/supabase`) nos prompts para pular o matching de bibliotecas e buscar docs diretamente.
- **Especificação de versão**: Mencionar uma versão no prompt (ex.: "Next.js 14") e o Context7 faz o matching da release apropriada automaticamente.
- **Comandos CLI**: `ctx7 library <name> <query>` pesquisa o índice; `ctx7 docs <libraryId> <query>` recupera trechos de documentação relevantes.
- **Ferramentas MCP**: `resolve-library-id` mapeia um nome geral para um ID compatível com Context7; `query-docs` busca documentação usando esse ID.
A plataforma oferece múltiplos pacotes de integração:
- `@upstash/context7-mcp` — servidor MCP para integração com agentes
- `ctx7` — CLI standalone
- `@upstash/context7-sdk` — SDK TypeScript
- `@upstash/context7-tools-ai-sdk` — ferramentas para Vercel AI SDK
- `@upstash/context7-pi` — extensão pi.dev
A configuração manual usa o endpoint MCP `https://mcp.context7.com/mcp` com uma chave de API Bearer. Mais de 30 plataformas clientes são suportadas com guias de configuração documentados.
Bibliotecas da comunidade são contribuídas por seus mantenedores. O Context7 inclui um mecanismo de reporte para conteúdo problemático e observa que o backend da API, o motor de parsing e o motor de crawling por trás do serviço são componentes privados não incluídos no repositório público. O projeto é licenciado sob MIT.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.