React Native代码修复工具

一个增强的React Native开发工具,提供专家级代码自动修复、组件重构和全面测试功能,适用于专业开发团队。

  • by Divagnz
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 Divagnz/React-Native-MCP

使用说明

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

获取帮助

有关详细的故障排除,请参阅:

报告问题时,包括:

  • 操作系统和版本
  • 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

✅ 按类别划分的测试覆盖率:

  1. 世博建云 (3个文件,23个测试)

    • build.test.ts:EAS云构建触发(8个测试)
    • status.test.ts:构建状态监控(8次测试)
    • submit.test.ts:应用商店提交(8项测试)
  2. 世博会本地建设 (3个文件,23个测试)

    • start.test.ts:本地构建启动(8次测试)
    • read.test.ts:构建日志监控(8个测试)
    • stop.test.ts:构建终止(6次测试)
  3. Expo开发服务器 (4个文件,31个测试)

    • start.test.ts:开发服务器生命周期(8个测试)
    • read.test.ts:日志流(7次测试)
    • send.test.ts:开发命令(9个测试)
    • stop.test.ts:服务器关闭(6次测试)
  4. 世博会项目工具 (4个文件,41个测试)

    • create.test.ts:项目脚手架(10次测试)
    • doctor.test.ts:健康诊断(9项测试)
    • install.test.ts:包装安装(9次测试)
    • upgrade.test.ts:SDK升级(13次测试)
  5. 世博会在线旅行社更新 (2个文件,24个测试)

    • publish.test.ts:更新发布(13项测试)
    • status.test.ts:更新监测(11项测试)
  6. 成分分析仪 (1个文件,22个测试)

    • React Native代码质量分析
    • 安全性、性能和内存泄漏检测
    • 样式表和缓存优化
  7. 咨询服务 (1个文件,35个测试)

    • 性能优化指导(6个场景)
    • 架构建议(7种模式)
    • 调试协助(5种问题类型,具体涉及平台)

🔧 质量改进:

  • 所有新测试都使用一致的模拟模式
  • 全面的边缘情况覆盖(错误处理、丢失数据、超时)
  • 特定平台的测试覆盖率(iOS、Android,两者都有)
  • 所有Expo CLI命令的输出解析验证

📊 工作流验证:

  • ✅ 所有测试均通过CI/CD管道
  • ✅ 过梁和类型检查通过
  • ✅ 自动生成覆盖徽章
  • ✅ PR检查中不允许跳过/等待测试

v0.0.1-初始版本

🚀 首次发布具有企业级功能:

  • 🏗️ 模块化架构 -基于服务的依赖注入设计
  • ⚡ 高级缓存 -具有智能驱逐功能的LRU缓存系统
  • 🧪 综合测试 -735个测试,分支覆盖率为91.38%
  • 📊 错误处理 -带断路器模式的结构化测井
  • 🔧 专家代码修正 -自动安全、性能和质量修复
  • 🏗️ 高级重构 -通过测试生成实现组件现代化

🎯 核心能力:

  • 17个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社区不断创新、全面的文档和无数的贡献,使移动开发每天都变得更好。