使用说明

React Native Blueprint MCP 服务器

一个简化的MCP服务器，用于创建具有渐进增强功能的最小化React Native项目。

概述

这个MCP服务器为AI助手提供了创建最小React Native项目的能力、全面的文档支持以及智能诊断功能。它遵循了（此处原文未给出具体内容，故无法直接翻译，若需补充，可继续如下）……的原则/流程/标准 最小化方法 - 从简单开始，仅在需要时增加复杂性。

特点/功能

🚀 火箭/飞速上升最小化项目创建

使用官方 React Native CLI（最新版本 0.82+）
在当前目录中创建项目
渐进增强以添加功能
自动解决依赖冲突

📚 书籍或阅读的象征全面的文档资料

50多个React Native文档章节
按类别、难度或标签筛选
个性化学习路径
官方React Native网站集成

🔍 看起来像是一个放大镜的符号，通常用于表示搜索、查看细节或寻找某物。在中文里，这个符号本身没有直接的翻译，但可以根据上下文理解为“查找”、“查看”或“搜索”的意思。例如：“🔍 我们需要找到这个细节。” 智能诊断

项目结构验证
错误诊断与修复
开发环境检查
自动问题解决

工具

1. `create_minimal_project` - 🚀 主要工具

使用官方CLI创建一个具备渐进增强功能的最小化React Native项目。

参数：

projectName （必填）：项目名称
projectPath （必填）：创建项目的路径（使用“.”表示当前目录）
useTypeScript （可选）：使用 TypeScript 模板（默认：true）
features （可选）：逐步添加的功能（导航、状态、HTTP、表单、存储）
pruneDefault （可选）：删除不必要的默认文件（默认：true）

2. `get_react_native_docs` - 📚 文档

从官方网站获取全面的React Native文档。

3. `get_learning_path` - 🎓 学习

根据经验水平（初学者、中级、高级）获取个性化学习路径。

4. `validate_project` - 🔍 验证

验证React Native项目结构并识别问题。

5. `diagnose_error` - 🩺 诊断

诊断特定的React Native错误并提供针对性的修复方案。

安装

先决条件

Node.js 18 或更高版本
npm 或 yarn

从npm安装

npm install -g react-native-blueprint-mcp

从源代码构建

# Clone the repository
git clone <repository-url>
cd react-native-blueprint-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Link globally (optional)
npm link

配置

将服务器添加到您的MCP客户端配置文件中：

Claude Desktop（可译为“Claude桌面版”或保持原样，根据上下文判断是否需要具体化为“Claude桌面应用程序”等）

编辑您的Claude桌面配置文件：

macOS（苹果电脑操作系统）： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "react-native-blueprint": {
      "command": "react-native-blueprint-mcp"
    }
  }
}

使用示例

示例1：创建最小项目

Create a minimal React Native project called "MyApp" with TypeScript and navigation

该人工智能将使用 create_minimal_project 创建一个采用渐进增强技术的干净React Native项目。

示例2：获取学习路径

I'm a beginner React Native developer, give me a learning path

人工智能将提供一条包含10个初级主题和预计时间的个性化学习路径。

示例3：诊断错误

I'm getting this error: "Cannot read properties of null (reading 'automaticPodsInstallation')"

人工智能将诊断错误，并为iOS项目初始化问题提供具体的修复方案。

示例4：验证项目

Validate my React Native project at /path/to/project

该人工智能将检查缺失的文件、配置问题，并提供具体的修复方案。

项目结构

src/
├── index.ts                 # Main server
├── types/
│   └── index.ts            # Shared types
└── tools/
    ├── index.ts            # Export all tools
    ├── minimal-project.ts  # Project creation
    ├── documentation.ts    # Docs and learning
    └── diagnostics.ts     # Validation and fixes

发展

构建

npm run build

观察模式

npm run watch

测试服务器

node dist/index.js

主要优势

✅ 最小化方法

从官方的 React Native CLI 开始
根据需要逐步添加功能
以最小的依赖实现最大的控制

✅ 确实有效

在当前目录中创建项目
自动解决依赖冲突
使用最新的React Native版本（0.82+）

✅ 综合学习

访问官方React Native文档
个性化学习路径
智能错误诊断与修复

✅ 开发者体验

简洁、专注的工具集
清除错误信息并修复
遵循React Native的最佳实践

更新日志

版本3.0.0 - 🔄 全面重构

简化版从19种工具减少到5种必备工具
专注的；集中的每种工具都有明确、特定的用途
极简的遵循最小化的React Native方法
可靠的运动部件越少，故障也就越少
清洁移除了冗余功能和文档

版本2.0.0 - Docker优先的Supabase

新Docker Compose 配置 Supabase
固定的当前目录项目创建
改进后的依赖冲突解决

版本1.0.0

首次发布，配备复杂脚手架

许可证

麻省理工学院（MIT）

支持

对于问题、疑问或建议：

在GitHub上提交一个问题
查看React Native文档
使用内置的诊断工具

为React Native社区倾心打造

使用说明

React Native Blueprint MCP 服务器

概述

特点/功能

🚀 火箭/飞速上升 最小化项目创建

📚 书籍或阅读的象征 全面的文档资料

工具

1. create_minimal_project - 🚀 主要工具

2. get_react_native_docs - 📚 文档

3. get_learning_path - 🎓 学习

4. validate_project - 🔍 验证

5. diagnose_error - 🩺 诊断

安装