React MCP (Model Context Protocol)

一个强大的服务器实现，使Claude AI能够通过模型上下文协议与React应用程序进行交互。

示例用法

• 由Claude提供的Markdown编辑器/查看器
  

• 由Claude提供的API测试工具
  

概览

React MCP为Claude AI和React生态系统之间提供了一个桥梁，允许Claude执行以下操作：

• 创建新的React应用程序
• 运行React开发服务器
• 管理文件和目录
• 安装npm包
• 执行终端命令
• 跟踪和管理长时间运行的进程

此服务器实现了模型上下文协议，使Claude能够在开发环境中执行实际操作。

功能

• React项目管理

  • 使用可选模板创建新的React应用程序
  • 运行开发服务器
  • 管理依赖项

• 文件操作

  • 读写文件
  • 编辑React组件和配置

• 进程管理

  • 启动并监控长时间运行的进程
  • 实时跟踪进程输出
  • 根据需要终止进程

• 命令执行

  • 运行任意终端命令
  • 安装npm包
  • 执行开发任务

• 全面的日志记录

  • 详细的JSON和文本日志
  • 带时间戳的进程跟踪
  • 执行历史

安装

1. 克隆此仓库
2. 安装依赖项：

npm install

使用

在claude_desktop_config中添加以下内容：

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

该服务器运行在stdio传输上，允许它作为模型上下文协议工具与Desktop Claude APP一起使用。

可用工具

create-react-app

创建一个新的React应用程序。

参数：

• name（必需）：React应用的名称
• template（可选）：使用的模板（例如，typescript, cra-template-pwa）
• directory（可选）：创建应用的基础目录（默认为主目录）

run-react-app

以开发模式运行React应用程序。

参数：

• projectPath（必需）：React项目文件夹的路径

run-command

运行终端命令。

参数：

• command（必需）：要执行的命令
• directory（可选）：运行命令的目录（默认为当前目录）

get-process-output

获取正在运行或已完成进程的输出。

参数：

• processId（必需）：要获取输出的进程ID

stop-process

停止一个正在运行的进程。

参数：

• processId（必需）：要停止的进程的ID

list-processes

列出所有正在运行的进程。

edit-file

创建或编辑一个文件。

参数：

• filePath（必需）：要编辑的文件路径
• content（必需）：要写入文件的内容

read-file

读取文件的内容。

参数：

• filePath（必需）：要读取的文件路径

install-package

在项目中安装一个 npm 包。

参数：

• packageName（必需）：要安装的包名称（可以包含版本）
• directory（可选）：项目的目录（默认为当前目录）
• dev（可选）：是否作为开发依赖项安装

check-installation-status

检查包安装过程的状态。

参数：

• processId（必需）：要检查的安装进程的ID

日志记录

服务器在 logs 目录中维护详细的日志：

• react-mcp-logs.json：结构化的 JSON 日志
• react-mcp-logs.txt：人类可读的文本日志

架构

服务器使用以下关键组件：

• Model Context Protocol SDK：用于与 Claude AI 通信
• StdioServerTransport：通过标准输入/输出进行 I/O
• Zod：用于模式验证和类型安全
• Child Process：用于生成和管理外部进程

许可证

MIT

作者

@streen9

贡献

欢迎贡献！请随时提交 Pull Request。