基本能力
产品定位
React MCP 是一个桥接 Claude AI 和 React 生态系统的工具,旨在通过模型上下文协议(MCP)实现 AI 与 React 开发环境的交互。
核心功能
- React 项目管理
- 创建新的 React 应用程序(支持模板)
- 运行开发服务器
- 管理依赖项
- 文件操作
- 读写文件
- 编辑 React 组件和配置
- 进程管理
- 启动和监控长时间运行的进程
- 实时跟踪进程输出
- 终止进程
- 命令执行
- 运行任意终端命令
- 安装 npm 包
- 执行开发任务
- 日志记录
- 详细的 JSON 和文本日志
- 带时间戳的进程跟踪
- 执行历史记录
适用场景
- 通过 AI 辅助创建和管理 React 项目
- 自动化 React 开发流程
- 远程或自动化执行开发任务
- 集成 AI 到开发工作流中
工具列表
create-react-app
:创建新的 React 应用程序run-react-app
:在开发模式下运行 React 应用程序run-command
:执行终端命令get-process-output
:获取运行中或已完成进程的输出stop-process
:停止运行中的进程list-processes
:列出所有运行中的进程edit-file
:创建或编辑文件read-file
:读取文件内容install-package
:在项目中安装 npm 包check-installation-status
:检查包安装过程的状态
常见问题解答
- 安装问题:确保已安装 Node.js 和 npm
- 配置问题:正确配置
claude_desktop_config
文件 - 进程管理:使用
list-processes
和stop-process
管理长时间运行的进程
使用教程
使用依赖
- Node.js 和 npm 已安装
安装教程
- 通过 Smithery 安装
bash
npx -y @smithery/cli install @Streen9/react-mcp --client claude - 手动安装
bash
git clone <repository-url>
cd react-mcp
npm install
调试方式
- 检查日志文件:
logs/react-mcp-logs.json
和logs/react-mcp-logs.txt
- 验证配置:确保
claude_desktop_config
中的路径正确 - 测试基本命令:如
create-react-app
或run-react-app