使用说明
React Native Expo MCP
[] [] [] []
React Native Expo MCP服务器-专业的AI驱动开发伙伴
专家补救•高级重构•企业架构•全面测试
📌 分叉通知: 该项目从 @mrnitro360/react原生mcp指南,增加了专家代码修复、高级组件重构、带依赖注入的模块化架构、全面的测试套件(478个测试)和企业级错误处理。
概述
为专业React Native开发团队设计的增强型模型上下文协议(MCP)服务器。基于企业级架构构建 专家级自动代码修复, 高级重构功能,全面测试和生产就绪修复。
🆕 v0.1.0-测试覆盖范围扩展和Expo CLI集成:
- 🧪 增强测试覆盖率 -933个测试(78.95%的行,90.22%的分支,81.43%的函数,78.91%的语句)
- ✅ 零覆盖消除 -覆盖率为0%的所有18个文件现在都有全面的测试套件
- 📦 Expo CLI集成 -用于开发服务器、构建、更新和项目管理的15个新工具
- 🏗️ 模块化架构 -干净、可维护的基于服务的设计,带有依赖注入
- ⚡ 高级缓存 -具有智能驱逐和性能优化的LRU缓存
- 📊 错误处理 -具有断路器和重试机制的结构化日志记录
- 🔧 专家代码修正 -自动修复安全、性能和质量问题
- 🏗️ 高级重构 -全面的组件现代化和优化
主要优势:
- 🚀 加速发展 -自动代码分析、修复和测试生成
- 🔒 企业安全 -具有自动修复功能的漏洞检测
- 📊 质量保证 -行业标准测试框架和覆盖率分析
- ⚡ 性能优化 -具有自动修复功能的高级分析
- 🎯 最佳实践 -代码实现专家指导
- 🔄 自动更新 -与自动版本管理的持续集成
快速开始
先决条件
- Node.js 18.0或更高
- Claude CLI 或 克劳德桌面
- React Native 开发环境
环境设置
要获得完整的Expo CLI功能,请配置以下环境变量:
Android开发所需
# Android SDK location
export ANDROID_HOME=$HOME/Android/Sdk
export ANDROID_SDK_ROOT=$HOME/Android/Sdk
# Add Android tools to PATH
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools
Java版本管理(推荐)
使用jenv管理Java版本:
# Install jenv (macOS)
brew install jenv
# Add to shell profile (~/.zshrc or ~/.bashrc)
export PATH="$HOME/.jenv/bin:$PATH"
eval "$(jenv init -)"
# Add Java versions
jenv add /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
# Set global version (Java 17+ recommended for React Native)
jenv global 17
# Verify
java -version # Should show 17.x.x or higher
最低Java版本: Java 17(LTS) 推荐: Java 17或21(LTS版本)
为什么选择Java 17? Android Gradle插件8.0+和现代React Native项目所需。旧版本可能会导致构建失败。
可选:EAS CLI身份验证
# For EAS cloud builds and updates
export EXPO_TOKEN=your_expo_token_here
export EAS_TOKEN=your_eas_token_here
安装
自动安装(推荐)
# Install globally via npm
npm install -g @divagnz/mcp-react-native-expo
# Configure with Claude CLI
claude mcp add mcp-react-native-expo npx @divagnz/mcp-react-native-expo
开发安装
# Clone repository
git clone https://github.com/Divagnz/mcp-react-native-expo.git
cd React-Native-MCP
# Install dependencies and build
npm install && npm run build
# Add to Claude CLI
claude mcp add mcp-react-native-expo node ./build/index.js
验证
claude mcp list
核实一下 mcp-react-native-expo 表现为 连接 ✅
🆕 专家补救示例
前后对比:自动代码修复
❌ 之前(问题代码):
const MyComponent = () => {
const apiKey = "sk-1234567890abcdef"; // Hardcoded secret
const [data, setData] = useState([]);
useEffect(() => {
console.log("API Key:", apiKey); // Sensitive logging
fetch('http://api.example.com/data') // HTTP instead of HTTPS
.then(response => response.json())
.then(data => setData(data));
const interval = setInterval(() => { // Memory leak
console.log('Polling...');
}, 1000);
}, []);
return (
<ScrollView>
{data.map(item => ( // Performance issue
<Text key={item.id} style={{color: 'red'}}>{item.name}</Text>
))}
</ScrollView>
);
};
✅ 之后(专家补救):
interface Props {
children?: React.ReactNode;
onPress?: () => void;
}
const MyComponent: React.FC<Props> = () => {
// TODO: Add API_KEY to your environment variables
const apiKey = process.env.API_KEY || Config.API_KEY;
const [data, setData] = useState([]);
useEffect(() => {
// Removed sensitive logging for security
// console.log('[REDACTED - contains sensitive data]');
// Upgraded to HTTPS for security
fetch('https://api.example.com/data')
.then(response => response.json())
.then(data => setData(data));
const interval = setInterval(() => {
console.log('Polling...');
}, 1000);
// Cleanup intervals to prevent memory leaks
return () => {
clearInterval(interval);
};
}, []);
return (
<FlatList
data={data}
keyExtractor={(item, index) => item.id?.toString() || index.toString()}
renderItem={({ item }) => (
<Text style={styles.itemText}>{item.name}</Text>
)}
/>
);
};
const styles = StyleSheet.create({
itemText: {
color: 'red'
}
});
export default React.memo(MyComponent);
🎯 自动修复的内容:
- ✅ 安全:硬编码API密钥→ 环境变量
- ✅ 安全:敏感记录→ 消毒
- ✅ 安全:HTTP→ HTTPS升级
- ✅ 演出:滚动视图+地图→ 带keyExtractor的平面列表
- ✅ 记忆:增加了间隔清理以防止泄漏
- ✅ 最佳实践:内联样式→ 样式表.create
- ✅ 类型安全:添加了TypeScript接口
- ✅ 演出:用React.memo包裹
核心功能
🔧 专家代码修正
| 工具 | 能力 | 水平 | 输出 |
|---|---|---|---|
remediate_code |
自动安全、性能和质量修复 | 专家 | 生产就绪代码 |
refactor_component |
高级组件现代化和优化 | 高级 | 经过测试的重构组件 |
| 安全补救 | 硬编码的秘密→ 环境变量 | 企业 | 安全代码模式 |
| 性能修复 | 内存泄漏、平面列表优化、样式表 | 专家 | 优化组件 |
| 类型安全 | 自动生成TypeScript接口 | 专业 | 类型安全代码 |
🧪 高级测试套件
| 功能 | 描述 | 框架 |
|---|---|---|
| 自动测试生成 | 组件的行业标准测试套件 | Jest,测试库 |
| 覆盖率分析 | 包含改进策略的详细报告 | Jest Coverage,LCOV |
| 战略评估 | 测试方法分析和建议 | 单元、集成、E2E |
| 框架集成 | 多平台测试支持 | 排毒、大师、斧头 |
🔍 综合分析工具
| 分析类型 | 能力 | 输出 |
|---|---|---|
| 安全审计 | 具有自动修复功能的漏洞检测 | 风险优先级报告+修复 |
| 性能分析 | 内存、渲染、捆绑优化+修复 | 可操作的建议+代码 |
| 代码质量 | 重构实现的复杂性分析 | 可维护性指标+修复 |
| 无障碍 | WCAG符合自动改进 | 合规报告+代码 |
📦 依赖管理
- 自动化包审核 -安全漏洞和过时的依赖关系
- 智能升级 -React Native兼容性验证
- 冲突解决 -依赖树优化
- 迁移助手 -弃用的软件包现代化
📚 专家知识库
- React原生文档 -完整的API参考资料和指南
- 体系结构模式 -可扩展的应用程序设计原则
- 平台指南 -iOS和Android特定的最佳实践
- 安全标准 -移动应用安全框架
使用示例
🔧 专家代码修正(新)
# Automatically fix all detected issues with expert-level solutions
claude "remediate_code with remediation_level='expert' and add_comments=true"
# Advanced component refactoring with performance optimization
claude "refactor_component with refactor_type='comprehensive' and include_tests=true"
# Security-focused remediation
claude "remediate_code with issues=['hardcoded_secrets', 'sensitive_logging'] and remediation_level='expert'"
# Performance-focused refactoring
claude "refactor_component with refactor_type='performance' and target_rn_version='latest'"
测试和质量保证
# Generate comprehensive component tests
claude "generate_component_test with component_name='LoginForm' and test_type='comprehensive'"
# Analyze testing strategy
claude "analyze_testing_strategy with focus_areas=['unit', 'accessibility', 'performance']"
# Generate coverage report
claude "analyze_test_coverage with coverage_threshold=85"
代码分析与优化
# Comprehensive codebase analysis with auto-remediation suggestions
claude "analyze_codebase_comprehensive"
# Performance optimization with specific focus areas
claude "analyze_codebase_performance with focus_areas=['memory_usage', 'list_rendering']"
# Security audit with vulnerability detection
claude "analyze_codebase_comprehensive with analysis_types=['security', 'performance']"
依赖管理
# Package upgrade recommendations
claude "upgrade_packages with update_level='minor'"
# Resolve dependency conflicts
claude "resolve_dependencies with fix_conflicts=true"
# Security vulnerability audit
claude "audit_packages with auto_fix=true"
现实世界场景
| 场景 | 命令 | 结果 |
|---|---|---|
| 🔧 自动代码修复 | "Fix all security and performance issues in my component with expert solutions" |
生产就绪修复代码 |
| 🏗️ 组件现代化 | "Refactor my legacy component to modern React Native patterns with tests" |
现代化组件+测试套件 |
| 🛡️ 安全强化 | "Automatically fix hardcoded secrets and security vulnerabilities" |
使用环境变量的安全代码 |
| ⚡ 性能优化 | "Fix memory leaks and optimize FlatList performance automatically" |
通过清理优化代码 |
| 📝 类型安全增强 | "Add TypeScript interfaces and improve type safety automatically" |
带接口的类型安全代码 |
| 部署前安全检查 | "Scan my React Native project for security vulnerabilities" |
安全报告+自动修复 |
| 性能瓶颈分析 | "Analyze my app for performance bottlenecks and memory leaks" |
优化路线图+修复 |
| 代码质量审查 | "Review my codebase for refactoring opportunities" |
质量改进+实施 |
| 无障碍合规性 | "Check my app for accessibility issues and fix them automatically" |
WCAG合规性+代码修复 |
| 组件测试生成 | "Generate comprehensive tests for my LoginScreen component" |
完整的测试套件 |
| 测试策略优化 | "Analyze my current testing strategy and suggest improvements" |
测试路线图 |
Claude桌面集成
NPM安装配置
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"mcp-react-native-expo": {
"command": "npx",
"args": ["@divagnz/mcp-react-native-expo@0.0.1"],
"env": {}
}
}
}
开发配置
{
"mcpServers": {
"mcp-react-native-expo": {
"command": "node",
"args": ["/absolute/path/to/React-Native-MCP/build/index.js"],
"env": {}
}
}
}
配置路径:
- 窗户:
C:\Users\{Username}\Desktop\React-Native-MCP\build\index.js - macOS/Linux:
/Users/{Username}/Desktop/React-Native-MCP/build/index.js
开发与维护
本地开发
# Development with hot reload
npm run dev
# Production build
npm run build
# Production server
npm start
持续集成
本项目实施企业级CI/CD:
- ✅ 自动化版本管理 -具有自动增量的语义版本控制
- ✅ 持续部署 -合并时自动发布npm
- ✅ 发布自动化 -GitHub发布了全面的变更日志
- ✅ 质量门 -部署前构建验证和测试
更新管理
# Check current version
npm list -g @divagnz/mcp-react-native-expo
# Update to latest version
npm update -g @divagnz/mcp-react-native-expo
# Reconfigure Claude CLI
claude mcp remove mcp-react-native-expo
claude mcp add mcp-react-native-expo npx @divagnz/mcp-react-native-expo
技术规格
🎯 分析和补救能力
- 专家代码修正 -自动修复安全、性能和质量问题
- 高级组件重构 -通过测试生成实现全面现代化
- 综合代码库分析 -带修复的多维质量评估
- 企业安全审计 -具有自动修复功能的漏洞检测
- 性能智能 -内存、渲染和捆绑包优化,并修复
- 质量指标 -重构实现的复杂性分析
- 无障碍合规性 -WCAG 2.1 AA标准验证,自动修复
- 测试策略优化 -覆盖范围分析和框架建议
🛠️ 技术架构
- 33专用工具 -完整的React Native开发生命周期覆盖+修复
- 17个核心分析和补救工具
- 15个Expo CLI集成工具
- 1个帮助/文档工具
- 2个专家补救工具 -
remediate_code和refactor_component - 6个专家提示模板 -结构化开发工作流程
- 5资源库 -全面的文档和最佳实践
- 行业标准测试生成 -自动创建测试套件
- 多框架集成 -Jest、Detox、Maestro和辅助工具
- 实时覆盖分析 -详细的报告和改进策略
- 生产就绪代码生成 -专家级自动修复和重构
🏢 企业功能
- 专家级补救 -高级工程师质量自动代码修复
- 生产就绪解决方案 -企业级安全和性能修复
- 专业报道 -执行层摘要和实施代码
- 安全第一架构 -全面的漏洞评估和修复
- 可扩展性规划 -具有重构的大规模应用程序设计模式
- 合规支持 -具有自动合规性修复的行业标准
- 多平台优化 -iOS和Android特定注意事项及修复
🗺️ 路线图
当前版本-v0.0.1✅
核心基础设施和基础
- ✅ 具有依赖注入的模块化架构
- ✅ 高级LRU缓存系统
- ✅ 综合测试套件(735+个测试,91.38%的分支覆盖率)
- ✅ 带断路器模式的结构化测井
- ✅ 专家代码修复能力
- ✅ 高级组件重构工具
- ✅ 17个专门的React Native开发工具
当前工具包括:
- 组件分析和优化
- 性能分析和优化
- 安全审计和补救
- 代码质量分析
- 测试策略和覆盖率分析
- 包管理和升级
- 调试指导
- 建筑建议
即将推出的功能🔜
Expo CLI集成(v0.1.0-计划中)
- 🔜 开发服务器管理(启动、二维码、日志、控件)
- 🔜 EAS云构建管理(触发、状态、提交)
- 🔜 项目管理工具(医生、安装、升级)
- 🔜 带推出控制的OTA更新发布
- 🔜 15个全面的Expo CLI工具(7个基于会话的工具+8个一次性工具)
ADB(安卓调试桥)集成
- 🔜 设备连接和管理
- 🔜 应用程序安装和卸载
- 🔜 Logcat监控和过滤
- 🔜 屏幕截图和屏幕录制
- 🔜 视觉回归测试
- 🔜 性能分析工具
- 🔜 完整的Android开发工作流程
iOS开发工具
- 🔜 模拟器管理
- 🔜 设备配置
- 🔜 构建和部署工具
- 🔜 iOS特定调试
- 🔜 试飞集成
- 🔜 完整的iOS开发工作流程
未来的增强功能
- 📋 增强的性能分析
- 📋 扩展可访问性测试
- 📋 CI/CD管道模板
- 📋 多平台工作流自动化
⚠️ 已知限制
当前版本(v0.1.0)
虽然MCP服务器提供了全面的React Native开发功能,但根据实际使用情况,存在一些已知的局限性:
流程管理
- 需要手动清理流程: 端口8081冲突必须使用手动解决
lsof -ti:8081 | xargs kill -9 - 无会话可见性: 无法轻松列出或监视活动的Expo/Metro进程
- 僵尸会话: 不自动清理孤立进程
解决方法:
- 在开始新会话之前手动终止进程
- 使用
ps aux | grep -E "expo|metro"查找正在运行的进程 - 开发中的工具:
expo_sessions_list,expo_kill_process,expo_cleanup
依赖管理
- 需要手动博览会医生: 用户必须运行
npx expo-doctor和npx expo install --check手动地 - 多次修复迭代: 依赖冲突(27+个包)需要多轮手动修复
- 版本降级: 一些软件包(例如,react native worklets 0.6.1→ 0.5.1) 需要人工注意
解决方法:
- 跑
npx expo install --check在主要建造之前 - 使用
expo install而不是yarn add世博会套餐 - 开发中的工具:
expo_doctor,expo_install_check
环境验证
- 后期构建失败: 在构建失败之前,未检测到环境问题(Java版本,ANDROID_HOME)
- Java 24不兼容: 没有飞行前检查Java版本与Gradle的兼容性
- 无主动警告: 构建10分钟后发现的问题
解决方法:
- 手动验证Java版本:
java -version(应该是17-21岁,而不是24岁以上) - 使用jenv管理Java版本:
jenv shell 17 - 在构建之前检查ANDROID_HOME:
echo $ANDROID_HOME - 开发中的工具:
expo_validate_environment
Polyfill检测
- 手动polyfill设置: 用户必须手动为Hermes添加Buffer和EventTarget polyfills
- 仅运行时错误: 只有在应用程序崩溃时才需要发现Polyfill
- 20+行手动代码: EventTarget实现需要手动编码
解决方法:
- 将polyfills添加到
app/_layout.tsx在其他进口之前 - 及早测试物理设备以发现Hermes问题
- 开发中的工具:
expo_detect_polyfills,expo_setup_polyfills
工具可靠性
- 60%的故障率: 在某些会话中,约60%的工具调用失败(而目标>95%)
- 工具命名混乱: 前缀尝试不正确(
mcp__react-native-guide__*对比mcp__mcp-react-native-expo__*) - 连接失败: MCP服务器重新连接失败,未进行诊断
- 未定义退货: 一些工具返回
undefined而不是正确的错误消息
解决方法:
- 检查工具名称
expo_help()(可用时) - 如果工具不可用,请重新启动Claude Desktop
- 使用
/mcp检查服务器状态的命令 - v0.2.0的改进正在进行中
日志管理
- 令牌溢出: 构建日志(34K+令牌)超过25K限制
- 详细分级输出: 300多行低值日志很难找到错误
- 无筛选: 无法仅查看错误或仅查看进度模式
解决方法:
- 使用
tail限制日志输出的参数 - 手动扫描日志以查找“ERROR”或“WARN”关键字
- 开发中的工具:智能日志过滤
--errors-only,--progress模式
影响总结
基于真实世界的使用分析:
- 约41分钟的体力劳动 按典型工作流程
- 16+次工具调用失败 在一次会议中
- 90%以上的问题是可以预防的 有计划的改进
改进时间表
看 改进_加载图.md 详细的改进计划。
所有改进都整合到v0.1.0版本中:
- ✅ 流程管理工具(会话列表、终止、清理)
- ✅ 所有工具的标准化响应格式
- ✅ 工具可靠性修复(零“无此类工具”错误)
- ✅ 依赖管理(expo-doctor、自动修复版本)
- ✅ 环境验证(预构建检查)
- ✅ Polyfill自动化(检测和设置)
- ✅ 智能日志记录(仅错误,进度跟踪)
- ✅ 构建诊断(超时检测、Gradle分析)
- ✅ 交互式帮助系统(expo_help,错误代码)
- ✅ 全面的文件
目标: >95%的工具成功率,每个工作流程的手动干预时间<5分钟
🔧 故障排除
常见问题的快速修复
端口8081已在使用中
# Find and kill the process
lsof -ti:8081 | xargs kill -9
# Or kill all Metro/Expo processes
pkill -f "metro|expo"
Java版本错误(Gradle构建)
# Check current version
java -version
# If showing Java 24, switch to 17 or 21
jenv shell 17
# Verify
java -version # Should show 17.x.x
缓冲区/事件目标多填充错误
添加 app/_layout.tsx (进口前):
// Minimal Buffer polyfill
if (typeof global.Buffer === 'undefined') {
global.Buffer = {
from: (data: any) => String(data),
isBuffer: () => false,
} as any;
}
// EventTarget polyfill
if (typeof global.EventTarget === 'undefined') {
global.EventTarget = class EventTarget {
private listeners = new Map();
addEventListener(type: string, listener: Function) {
if (!this.listeners.has(type)) {
this.listeners.set(type, new Set());
}
this.listeners.get(type)?.add(listener);
}
removeEventListener(type: string, listener: Function) {
this.listeners.get(type)?.delete(listener);
}
dispatchEvent(event: any) {
this.listeners.get(event.type)?.forEach(l => l(event));
return true;
}
} as any;
}
依赖版本冲突
# Check for issues
npx expo-doctor
# Auto-fix all
npx expo install --check --fix
# Install missing peer dependencies
yarn add @expo/metro-runtime react-native-worklets
MCP工具不可用
# Verify MCP configuration
cat ~/.config/claude-desktop/mcp.json
# Restart Claude Desktop
# Or use /mcp command in Claude
获取帮助
有关详细的故障排除,请参阅:
- PAIN_POINTS.md -结合实例进行综合痛点分析
- EXPO_TOOLS_SPEC.md -详细的Expo工具故障排除
- GitHub问题 -报告错误和请求功能
报告问题时,包括:
- 操作系统和版本
- Node.js版本(
node --version) - Expo SDK版本(
npx expo --version) - Java版本(
java -version) - 完整的错误日志
- 重现步骤
📋 更新日志
v0.1.0-测试覆盖范围扩展和Expo CLI集成(最新)
🧪 增强测试覆盖率:
- 198项新测试 在12个文件中添加,以消除0%的功能覆盖率
- 933次测试 (从735上升)
- 覆盖范围改善:
- 线:78.95%(以前为74.1%)
- 分支机构:90.22%(稳定)
- 功能:81.43%(高于~75%)
- 声明:78.91%(高于74.1%)
- 全部18个文件 覆盖率为0%,现在拥有全面的测试套件(每个套件覆盖率超过25%)
📦 Expo CLI集成(15个新工具):
- 开发服务器管理 (4个工具):
expo_start_dev_server,expo_read_dev_logs,expo_send_dev_command,expo_stop_dev_server - EAS云构建 (3个工具):
expo_trigger_eas_build,expo_get_eas_build_status,expo_submit_to_store - 当地建筑 (3个工具):
expo_start_local_build,expo_read_build_logs,expo_stop_local_build - 项目管理 (3个工具):
expo_create_app,expo_run_doctor,expo_install_packages,expo_upgrade_sdk - OTA更新 (2个工具):
expo_publish_eas_update,expo_get_update_status
✅ 按类别划分的测试覆盖率:
-
世博建云 (3个文件,23个测试)
build.test.ts:EAS云构建触发(8个测试)status.test.ts:构建状态监控(8次测试)submit.test.ts:应用商店提交(8项测试)
-
世博会本地建设 (3个文件,23个测试)
start.test.ts:本地构建启动(8次测试)read.test.ts:构建日志监控(8个测试)stop.test.ts:构建终止(6次测试)
-
Expo开发服务器 (4个文件,31个测试)
start.test.ts:开发服务器生命周期(8个测试)read.test.ts:日志流(7次测试)send.test.ts:开发命令(9个测试)stop.test.ts:服务器关闭(6次测试)
-
世博会项目工具 (4个文件,41个测试)
create.test.ts:项目脚手架(10次测试)doctor.test.ts:健康诊断(9项测试)install.test.ts:包装安装(9次测试)upgrade.test.ts:SDK升级(13次测试)
-
世博会在线旅行社更新 (2个文件,24个测试)
publish.test.ts:更新发布(13项测试)status.test.ts:更新监测(11项测试)
-
成分分析仪 (1个文件,22个测试)
- React Native代码质量分析
- 安全性、性能和内存泄漏检测
- 样式表和缓存优化
-
咨询服务 (1个文件,35个测试)
- 性能优化指导(6个场景)
- 架构建议(7种模式)
- 调试协助(5种问题类型,具体涉及平台)
🔧 质量改进:
- 所有新测试都使用一致的模拟模式
- 全面的边缘情况覆盖(错误处理、丢失数据、超时)
- 特定平台的测试覆盖率(iOS、Android,两者都有)
- 所有Expo CLI命令的输出解析验证
📊 工作流验证:
- ✅ 所有测试均通过CI/CD管道
- ✅ 过梁和类型检查通过
- ✅ 自动生成覆盖徽章
- ✅ PR检查中不允许跳过/等待测试
v0.0.1-初始版本
🚀 首次发布具有企业级功能:
- 🏗️ 模块化架构 -基于服务的依赖注入设计
- ⚡ 高级缓存 -具有智能驱逐功能的LRU缓存系统
- 🧪 综合测试 -735个测试,分支覆盖率为91.38%
- 📊 错误处理 -带断路器模式的结构化测井
- 🔧 专家代码修正 -自动安全、性能和质量修复
- 🏗️ 高级重构 -通过测试生成实现组件现代化
🎯 核心能力:
- 17个React Native开发专用工具
- 专家代码修复和重构
- 具有自动修复功能的安全审计
- 性能优化和分析
- 全面的代码库分析
- 测试策略和覆盖率分析
- 包管理和依赖关系解决
- 可访问性合规性检查
支持与社区
资源
- 📦 NPM包 -官方软件包存储库
- 🐙 GitHub存储库 -源代码和开发
- 🐛 问题追踪 -Bug报告和功能请求
- 📖 MCP文件 -模型上下文协议规范
- ⚛️ React原生文档 -React Native官方文档
贡献
我们欢迎React Native社区的贡献。请查看我们的 贡献指南 开发标准和提交流程。
许可证
该项目根据 MIT许可证。有关详细的条款和条件,请参阅许可证文件。
专业React原生开发,专家级修复
通过自动化的专家级代码修复,使开发团队能够构建安全、高性能和可访问的移动应用程序
🆕 v0.0.1-首次发布!
🆕 这个叉子有什么新功能
该项目是一个显著增强的分支 @mrnitro360/react原生mcp指南我们已将原始基础转化为具有专家级自动化的企业级开发伙伴。
主要添加和增强
1.🔧 专家代码修复系统
原件: 基本代码分析 这个叉子: 生产就绪自动修复
remediate_code工具 -自动修复安全漏洞、性能问题和代码质量问题refactor_component工具 -通过钩子、TypeScript和性能优化实现全面的组件现代化- 自动修复包括:
- 安全:硬编码的秘密→ 环境变量,HTTP→ HTTPS升级
- 性能:内存泄漏清理,ScrollView→ 平面列表优化、样式表提取
- 质量:TypeScript接口生成、React.memo封装、道具验证
- 最佳实践:内联样式→ 样式表,使用中的正确清理效果
2.🏗️ 企业架构
原件: 单文件实现 这个叉子: 基于模块化服务的架构
- 依赖注入 清晰地分离关注点
- 高级LRU缓存 具有智能驱逐和性能优化功能
- 结构化日志记录 使用Winston、断路器模式和重试机制
- 综合测试 -735+次测试(原始测试为~0次)
- 91.38%的分行覆盖率
- 78.95%的线路覆盖率
- 单元、集成和边缘案例测试
- 测试库集成的恶作剧
3.📦 扩展工具套件
原件: 8种基本分析工具 这个叉子: 17种专业工具
新增工具:
remediate_code-专家级自动代码修复refactor_component-先进的组件现代化analyze_codebase_comprehensive-具有自动修复建议的多维分析analyze_codebase_performance-具有自动优化功能的性能分析generate_component_test-自动生成测试套件analyze_test_coverage-覆盖率分析及改进策略analyze_testing_strategy-测试方法评估和建议upgrade_packages-具有兼容性检查的智能软件包升级resolve_dependencies-依赖冲突解决audit_packages-具有自动修复功能的安全漏洞审计
4.🧪 先进的测试能力
原件: 无测试基础设施 这个叉子: 行业标准测试套件
- 自动生成测试 使用Jest和React Native测试库
- 多种测试框架 -排毒、大师、笑斧融合
- 覆盖率分析 具有详细的改进策略
- 测试策略评估 -单元、集成、E2E建议
- 可访问性测试 -WCAG 2.1 AA合规性检查
5.🛡️ 安全与性能
原件: 基本代码扫描 这个叉子: 具有自动修复功能的专家补救
- 安全审计 -具有自动修复功能的漏洞检测
- 硬编码秘密检测和环境变量转换
- 敏感日志清理
- HTTP到HTTPS升级
- 性能优化 -内存和渲染分析及其修复
- 内存泄漏检测和清理代码生成
- 列表渲染优化(ScrollView→ 平面列表)
- 捆绑包大小分析和代码拆分建议
- 代码质量 -重构实现的复杂性分析
- 圈复杂度降低
- 代码重复检测和提取
- 具有可操作修复的可维护性指标
6.🚀 CI/CD和自动化
原件: 手动部署 这个叉子: 全自动工作流程
- GitHub操作 -自动PR检查、测试和部署
- 自动化版本管理 -具有自动增量的语义版本控制
- NPM出版 -在合并到主时持续部署
- 预提交挂钩 -哈士奇配皮棉,保证代码质量
- 质量门 -部署前构建验证、测试和linting
7.📚 综合文档
原件: 基本自述文件 这个叉子: 企业级文件
- 6个专家提示模板 -结构化开发工作流程
- 5资源库 -完整的React Native文档和最佳实践
- 真实世界的例子 -带有详细解释的前/后代码
- 故障排除指南 -常见问题及解决方案
- 贡献指南 -综合开发标准
- 痛点分析 -真实世界的使用跟踪和改进路线图
对比总结
| 功能 | 原始分叉 | 这款增强型分叉 |
|---|---|---|
| 工具 | 8个基本工具 | 17个专业工具 |
| 测试 | 无测试 | 735+综合测试(91.38%的分支覆盖率) |
| 建筑 | 单文件 | 基于DI的模块化服务 |
| 代码修复 | 仅手动 | 自动专家级补救 |
| 安全 | 仅检测 | 检测+自动修复 |
| 演出 | 仅分析 | 分析+自动优化 |
| CI/CD | 无 | 完全GitHub操作自动化 |
| 文档 | 基础 | 企业级,附示例 |
| 缓存 | 无 | 具有智能驱逐功能的高级LRU |
| 错误处理 | 基本 | 断路器+重试机制 |
影响指标
- 提高生产率: 自动修复可将手动编码减少约60%
- 代码质量: 100%TypeScript,具有全面的类型安全性
- 测试覆盖范围: 从0%到91.38%的分支覆盖率
- 安全: 自动修复漏洞
- 开发时间: 专家级解决方案只需几秒钟,而不是几小时
路线图补充
计划用于v0.1.0:
- 15个Expo CLI工具(开发服务器、EAS构建、OTA更新)
- 增强的会话管理
- 智能日志过滤
未来版本:
- ADB(安卓调试桥)集成
- iOS开发工具(模拟器、配置、TestFlight)
- 多平台工作流自动化
🙏 致谢
这个项目建立在React Native和MCP社区的优秀工作之上:
-
React原生团队 -创建和维护优秀的React Native框架,使跨平台移动开发变得可访问和强大。
-
@mrnitro360 -原作者 反应本地mcp指南,为该增强型服务器提供了基础。感谢您开创React Native MCP集成。
-
世博会团队 -用于构建令人难以置信的Expo生态系统,简化React Native开发,并使用EAS Build和OTA更新等工具实现快速迭代。
-
Anthropic -用于开发模型上下文协议(MCP)和Claude,实现强大的人工智能辅助开发工作流程,提高开发人员的生产力。
特别感谢更广泛的React Native社区不断创新、全面的文档和无数的贡献,使移动开发每天都变得更好。