Skip to main content
Glama
https://github.com/Streen9/react-mcp

https://github.com/Streen9/react-mcp

React MCP (Protocolo de contexto de modelo)

insignia de herrería

Una poderosa implementación de servidor que permite a Claude AI interactuar con aplicaciones React a través del Protocolo de Contexto de Modelo.

Ejemplo de uso

Related MCP server: MCP-Claude Code Bridge

Descripción general

React MCP proporciona un puente entre Claude AI y el ecosistema React, lo que le permite a Claude:

  • Crear nuevas aplicaciones React

  • Ejecutar servidores de desarrollo de React

  • Administrar archivos y directorios

  • Instalar paquetes npm

  • Ejecutar comandos de terminal

  • Seguimiento y gestión de procesos de larga duración

Este servidor implementa el Protocolo de Contexto de Modelo, proporcionando a Claude la capacidad de realizar acciones del mundo real en el entorno de desarrollo.

Características

  • Gestión de proyectos React

    • Cree nuevas aplicaciones React con plantillas opcionales

    • Ejecutar servidores de desarrollo

    • Administrar dependencias

  • Operaciones con archivos

    • Leer y escribir archivos

    • Editar componentes y configuración de React

  • Gestión de procesos

    • Iniciar y supervisar procesos de larga duración

    • Seguimiento del resultado del proceso en tiempo real

    • Terminar procesos cuando sea necesario

  • Ejecución de comandos

    • Ejecutar comandos de terminal arbitrarios

    • Instalar paquetes npm

    • Ejecutar tareas de desarrollo

  • Registro completo

    • Registros detallados de JSON y texto

    • Seguimiento de procesos con marcas de tiempo

    • Historial de ejecuciones

Instalación

  1. Clonar este repositorio

  2. Instalar dependencias:

npm install

Uso

Agregue esto en claude_desktop_config :

{
  "mcpServers": {
    "react-mcp": {
      "command": "node",
      "args": [
        "C:/Users/kalip/OneDrive/Desktop/react-mcp/index.js"
      ]
    },
  }
}

El servidor se ejecuta en el transporte stdio, lo que permite su uso con la aplicación Desktop Claude como herramienta de protocolo de contexto de modelo.

Herramientas disponibles

create-react-app

Crea una nueva aplicación React.

Parámetros:

  • name (obligatorio): Nombre de la aplicación React

  • template (opcional): Plantilla a utilizar (por ejemplo, typescript, cra-template-pwa)

  • directory (opcional): directorio base para crear la aplicación (predeterminado: directorio de inicio)

run-react-app

Ejecuta una aplicación React en modo de desarrollo.

Parámetros:

  • projectPath (obligatorio): Ruta a la carpeta del proyecto React

run-command

Ejecuta un comando de terminal.

Parámetros:

  • command (obligatorio): Comando a ejecutar

  • directory (opcional): directorio donde ejecutar el comando (predeterminado: el directorio actual)

get-process-output

Obtiene la salida de un proceso en ejecución o completado.

Parámetros:

  • processId (obligatorio): ID del proceso del que se obtendrá la salida

stop-process

Detiene un proceso en ejecución.

Parámetros:

  • processId (obligatorio): ID del proceso a detener

list-processes

Enumera todos los procesos en ejecución.

edit-file

Crea o edita un archivo.

Parámetros:

  • filePath (obligatorio): Ruta al archivo a editar

  • content (obligatorio): Contenido que se escribirá en el archivo

read-file

Lee el contenido de un archivo.

Parámetros:

  • filePath (obligatorio): Ruta al archivo a leer

install-package

Instala un paquete npm en un proyecto.

Parámetros:

  • packageName (obligatorio): Nombre del paquete a instalar (puede incluir la versión)

  • directory (opcional): Directorio del proyecto (predeterminado: directorio actual)

  • dev (opcional): si se instalará como una dependencia de desarrollo

check-installation-status

Comprueba el estado de un proceso de instalación de un paquete.

Parámetros:

  • processId (obligatorio): ID del proceso de instalación a comprobar

Explotación florestal

El servidor mantiene registros detallados en el directorio logs :

  • react-mcp-logs.json : Registros JSON estructurados

  • react-mcp-logs.txt : registros de texto legibles para humanos

Arquitectura

El servidor utiliza los siguientes componentes clave:

  • SDK de protocolo de contexto de modelo : para la comunicación con Claude AI

  • StdioServerTransport : para E/S a través de entrada/salida estándar

  • Zod : para validación de esquemas y seguridad de tipos

  • Proceso hijo : para generar y gestionar procesos externos

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Autor

@streen9

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Available Tools

9 tools
create-react-appC

Create a new React application

Inputs: name (required), template, directory.

edit-fileC

Create or edit a file

Inputs: content (required), filePath (required).

get-process-outputB

Get the output from a running or completed process

Inputs: processId (required).

install-packageC

Install a npm package in a project

Inputs: packageName (required), dev, directory.

list-processesA

List all running processes

Inputs: no named parameters.

read-fileB

Read the contents of a file

Inputs: filePath (required).

run-commandC

Run a terminal command

Inputs: command (required), directory.

run-react-appC

Run a React application in development mode

Inputs: projectPath (required).

stop-processB

Stop a running process

Inputs: processId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 9 tools

    Disambiguation4/5

    Tools are mostly distinct: process management (list, stop, get output), file operations (read/edit), and React-specific actions (create/run app) are clearly separated. However, 'run-react-app' and generic 'run-command' could be confused if an agent doesn't read descriptions, and 'run-command' overlaps slightly with the dev server startup.

    Naming Consistency5/5

    All tools follow a consistent verb_noun snake_case pattern (e.g., stop-process, create-react-app, list-processes). No deviations or mixed conventions, making the naming predictable and intuitive.

    Tool Count5/5

    With 9 tools, the server covers the core React development workflow (create, run, manage processes, edit files, install packages) without redundancy. Each tool serves a clear purpose and the count is well within the ideal 3-15 range.

    Completeness4/5

    The toolset covers the essential React development lifecycle: project creation, dev server management, file editing, package installation, and process monitoring. Minor gaps like build/test commands or file deletion are missing but agents can work around them using run-command or edit-file.

    Related MCP Connectors

    Related MCP Servers