react-native-docs-mcp

Búsqueda semántica local en la documentación de React Native para agentes de IA — sin clave API

GitHubPrueba este MCPPatrocinado

Documentación

React Native Docs MCP

React Native Docs MCP Server

Búsqueda semántica impulsada por IA sobre la documentación de React Native para Claude, Cursor y otros clientes MCP.

¿Buscas documentación de React en su lugar? Consulta react-docs-mcp.

🚀 Instalación (Un Comando)

Claude Code

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

Claude Desktop

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

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

Cursor

Configuración → Configuración de Cursor → Herramientas y MCP → Añadir servidor:

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

¡Eso es todo! Reinicia tu editor y pregunta sobre React Native.

Características

  • 🔑 Sin clave de API: A diferencia de los servicios de documentación alojados (Context7, GitMCP), todo se ejecuta en tu máquina — sin cuenta, sin clave, sin límites de velocidad
  • 🔌 Funciona sin conexión: Clona el repositorio oficial de documentación react-native-website una vez y luego busca localmente — sin llamadas de red al momento de la consulta
  • 🔍 Búsqueda semántica: Búsqueda impulsada por IA que usa embeddings para coincidencias conceptuales
  • ⚡ Resultados rápidos: Búsqueda vectorial en memoria con clasificación híbrida por palabras clave + semántica
  • 📦 Cero configuración: Funciona con npx - no se necesita instalación
  • 🤖 IA local: Ejecuta embeddings localmente (sin costos de API)
  • 📝 Respuestas concisas: Devuelve resúmenes en lugar de documentación completa
  • 🔄 Sincronización automática: Obtiene la documentación más reciente del repositorio react-native-website automáticamente
  • 📌 Fijación de versión: --docs-version=0.77 limita la documentación a la versión de React Native que tu aplicación realmente usa

Uso

Una vez configurado, el servidor proporciona las siguientes capacidades a los agentes de IA:

Herramientas

search_react_native_docs

Busca en la documentación de React Native.

Parámetros:

  • query (obligatorio): Cadena de consulta de búsqueda
  • section (opcional): Filtrar por sección (the-new-architecture, legacy, releases)
  • limit (opcional): Número máximo de resultados (predeterminado: 10, máximo: 50)

Ejemplo:

Search for "flexbox layout" in React Native docs

get_doc

Obtiene una página de documentación específica.

Parámetros:

  • path (obligatorio): Ruta del documento (p. ej., "getting-started", "the-new-architecture/using-codegen")
  • full (opcional): Devuelve la página completa sin procesar en lugar del resumen de ~1500 caracteres (predeterminado: false)

Ejemplo:

Get the React Native flexbox documentation

¿Por qué full? El resumen predeterminado es suficiente para la mayoría de las páginas de referencia, pero las guías largas — como la documentación de migración de "The New Architecture" o un recorrido completo de módulos nativos — pueden superar con creces los 1500 caracteres, y el resumen puede detenerse antes de la parte que realmente necesitas. Solicita la página completa cuando eso ocurra:

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

que llama a get_doc con { "path": "the-new-architecture/using-codegen", "full": true }.

list_sections

Lista todas las secciones de documentación disponibles.

update_docs

Obtiene la documentación más reciente del repositorio Git.

Versión de la documentación

Por defecto, este servidor indexa la carpeta docs/ siempre actual del repositorio react-native-website — la misma documentación que se muestra hoy en reactnative.dev. Para fijarla a la instantánea congelada de la documentación de una versión anterior específica, pasa --docs-version:

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

o establece la variable de entorno REACT_NATIVE_DOCS_VERSION (la bandera de CLI tiene prioridad si ambas están configuradas). Con Claude Code:

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

(--version sin argumentos imprime la versión del paquete, como esperarías de cualquier CLI).

¿Por qué fijar una versión? Si tu aplicación ejecuta React Native 0.77 pero el agente busca en la documentación siempre actual, puede sugerir una API que solo existe en 0.86, o pasar por alto que algo fue renombrado/eliminado desde tu versión. Fijar --docs-version para que coincida con la versión de tu dependencia react-native mantiene las sugerencias coherentes con las API realmente disponibles en tu aplicación — útil cuando trabajas en una aplicación que está unas versiones por detrás de la última, o al depurar algo específico de una versión (p. ej., "¿cambió este comportamiento de New Architecture entre 0.78 y 0.82?" — ejecuta dos instancias, una por versión, y compara).

Solo latest (el predeterminado) está completamente verificado contra la estructura actual de la documentación; las instantáneas de versiones anteriores se indexan con el mejor esfuerzo posible con la misma configuración.

Recursos

El servidor expone la documentación como recursos con el patrón de URI:

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

Limitaciones

  • Fuente de la documentación: el contenido se clona de la carpeta sin versionar docs/ en facebook/react-native-website, que es la fuente de edición en vivo del proyecto upstream. Puede estar ocasionalmente unos días por delante de la última versión publicada en lugar de estar fijada a una versión específica de React Native.
  • Secciones: la mayoría de las páginas de documentación de React Native viven planas en la raíz de docs/ sin una sección significativa — solo the-new-architecture, legacy y releases son subcarpetas reales. El filtro section reduce los resultados de manera confiable solo para esas tres; para todo lo demás, busca sin filtrar.
  • Publicaciones del blog: website/blog/ aún no está indexado.
  • Renderizado MDX: la sintaxis exclusiva de .mdx (importaciones de componentes JSX, admoniciones) se elimina como texto plano con el mejor esfuerzo posible para la indexación de búsqueda, por lo que los fragmentos/resúmenes de algunas páginas pueden incluir líneas de importación sueltas.

Desarrollo

Este paquete comparte su motor con react-docs-mcp — el desarrollo ocurre en ese monorepo (este repositorio independiente es un espejo de solo lectura de packages/react-native-docs-mcp/; por favor, reporta los problemas allí). El código fuente de este paquete solo configura el motor compartido con valores predeterminados específicos de React Native (src/index.ts) y se empaqueta de forma independiente con tsup.

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

Licencia

MIT. El contenido de la documentación de React Native es © Meta Platforms, Inc. y está licenciado por separado por el proyecto react-native-website.