react-native-docs-mcp

React Native Docs MCP Server

Busca semântica com IA sobre a documentação do React Native para Claude, Cursor e outros clientes MCP.

Procurando pela documentação do React? Veja react-docs-mcp.

🚀 Instalação (Um Comando)

Claude Code

claude mcp add --transport stdio react-native-docs -- npx react-native-docs-mcp

Claude Desktop

Edite: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "react-native-docs": {
      "command": "npx",
      "args": ["-y", "react-native-docs-mcp"]
    }
  }
}

Cursor

Settings → Cursor settings → Tools and MCP → Add server:

{
  "mcpServers": {
    "react-native-docs": {
      "command": "npx",
      "args": ["-y", "react-native-docs-mcp"]
    }
  }
}

Pronto! Reinicie o editor e pergunte sobre React Native.

---

Recursos

• 🔑 Sem chave de API: Diferente de serviços de documentação hospedados (Context7, GitMCP), tudo roda na sua máquina — sem conta, sem chave, sem limites de requisição
• 🔌 Funciona offline: Clona o repositório oficial de documentação react-native-website uma vez e depois faz buscas localmente — sem chamadas de rede no momento da consulta
• 🔍 Busca semântica: Busca com IA usando embeddings para correspondências conceituais
• ⚡ Resultados rápidos: Busca vetorial em memória com ranqueamento híbrido por palavras-chave + semântica
• 📦 Zero configuração: Funciona com npx — sem necessidade de instalação
• 🤖 IA local: Executa embeddings localmente (sem custos de API)
• 📝 Respostas concisas: Retorna resumos em vez da documentação completa
• 🔄 Sincronização automática: Puxa as últimas versões da documentação do repositório react-native-website automaticamente
• 📌 Fixação de versão: --docs-version=0.77 restringe a documentação à versão do React Native que seu app realmente usa

Uso

Uma vez configurado, o servidor oferece as seguintes capacidades aos agentes de IA:

Ferramentas

search_react_native_docs

Busca na documentação do React Native.

Parâmetros:

• query (obrigatório): string da consulta de busca
• section (opcional): filtra por seção (the-new-architecture, legacy, releases)
• limit (opcional): número máximo de resultados (padrão: 10, máximo: 50)

Exemplo:

Search for "flexbox layout" in React Native docs

get_doc

Obtém uma página específica da documentação.

Parâmetros:

• path (obrigatório): caminho do documento (ex.: "getting-started", "the-new-architecture/using-codegen")
• full (opcional): retorna a página bruta completa em vez do resumo de ~1500 caracteres (padrão: false)

Exemplo:

Get the React Native flexbox documentation

Por que full? O resumo padrão é suficiente para a maioria das páginas de referência, mas guias longos — como a documentação de migração da "Nova Arquitetura" ou um passo a passo completo de módulos nativos — podem passar de 1500 caracteres, e o resumo pode parar antes da parte que você realmente precisa. Peça a página completa quando isso acontecer:

Get the full page for the-new-architecture/using-codegen, I need every step

que chama get_doc com { "path": "the-new-architecture/using-codegen", "full": true }.

list_sections

Lista todas as seções de documentação disponíveis.

update_docs

Puxa a documentação mais recente do repositório Git.

Versão da documentação

Por padrão, este servidor indexa a pasta docs/ sempre atual do repositório react-native-website — a mesma documentação exibida em reactnative.dev hoje. Para fixá-la em um snapshot congelado de uma versão anterior específica, passe --docs-version:

npx react-native-docs-mcp --docs-version=0.77

ou defina a variável de ambiente REACT_NATIVE_DOCS_VERSION (a flag da CLI prevalece se ambas forem definidas). Com Claude Code:

claude mcp add --transport stdio react-native-docs -- npx react-native-docs-mcp --docs-version=0.77

(Apenas --version imprime a versão do pacote, como você esperaria de qualquer CLI.)

Por que fixar uma versão? Se o seu app roda React Native 0.77 mas o agente busca a documentação sempre atual, ele pode sugerir uma API que só existe na 0.86, ou deixar de notar que algo foi renomeado/removido desde a sua versão. Fixar --docs-version para corresponder à versão da sua dependência react-native mantém as sugestões consistentes com as APIs realmente disponíveis no seu app — útil ao trabalhar em um app algumas versões atrás da mais recente, ou ao depurar algo específico de uma versão (ex.: "esse comportamento da Nova Arquitetura mudou entre 0.78 e 0.82?" — rode duas instâncias, uma por versão, e compare).

Somente latest (o padrão) é totalmente verificado em relação à estrutura atual da documentação; snapshots de versões mais antigas são indexados da melhor forma possível com as mesmas configurações.

Recursos

O servidor expõe a documentação como recursos com o padrão de URI:

react-native-docs://{section}/{path}

Limitações

• Fonte da documentação: o conteúdo é clonado da pasta sem versão docs/ em facebook/react-native-website, que é a fonte de edição ativa do upstream. Às vezes ela pode estar alguns dias à frente da última versão publicada, em vez de fixada em uma versão específica do React Native.
• Seções: a maioria das páginas da documentação do React Native fica na raiz de docs/ sem seção significativa — apenas the-new-architecture, legacy e releases são subpastas reais. O filtro section restringe os resultados de forma confiável somente para essas três; para todo o resto, busque sem filtro.
• Postagens do blog: website/blog/ ainda não é indexado.
• Renderização MDX: a sintaxe exclusiva de .mdx (imports de componentes JSX, admonitions) é removida como texto simples aproximado para indexação de busca, então trechos/resumos de algumas páginas podem incluir linhas de import avulsas.

Desenvolvimento

Este pacote compartilha seu mecanismo com react-docs-mcp — o desenvolvimento acontece nesse monorepo (este repositório independente é um espelho somente leitura de packages/react-native-docs-mcp/; por favor, registre problemas lá). O código-fonte deste pacote apenas configura o mecanismo compartilhado com padrões específicos do React Native (src/index.ts) e é empacotado de forma independente com tsup.

npm install
npm run build
npm run dev   # run directly with tsx, no build step

Licença

MIT. O conteúdo da documentação do React Native é © Meta Platforms, Inc. e é licenciado separadamente pelo projeto react-native-website.