Expo MCP Server

Expo MCP Server

site icon
2025.04.23 0
TypeScriptReact Native 开发工具调试工具日志管理开发效率
Expo MCP Server 是一个为基于 Expo 的 React Native 应用程序提供开发和调试工具的 Model Context Protocol (MCP) 服务器。该项目集成了日志记录、进程管理和文件工具,以简化和自动化基于 AI 的工作流程。
View on GitHub

Overview

基本能力

产品定位

Expo MCP Server 是一个为基于 Expo 的 React Native 应用程序提供开发和调试工具的 MCP 服务器。

核心功能

  • 启动、停止和监控 Expo 开发服务器
  • 捕获和过滤 stdout / stderr 日志
  • 读取、写入和列出项目目录中的文件
  • 查询日志统计信息并清除日志
  • 可通过自定义 MCP 工具扩展
  • 包含用于 AI 处理的打包单文件表示(通过 Repomix)

适用场景

  • React Native 应用程序的开发和调试
  • 自动化工作流程
  • AI 辅助开发

工具列表

工具名称 描述
expoStart 启动 Expo 开发服务器(默认 iOS)
expoStop 停止运行的 Expo 开发服务器
expoStatus 显示 Expo 服务器的状态和日志
expoLogs 检索最近的 Expo 日志
expoGetLogs 带有高级选项的过滤日志
expoLogStats 当前日志的摘要统计信息
expoClearLogs 清除所有存储的日志
readFile 读取文件内容
writeFile 将内容写入文件
listFiles 列出目录中的文件
listTools 列出服务器中注册的所有工具

常见问题解答

  • MCP 服务器关闭并不总是杀死子 Expo 进程
  • 依赖全局状态来跟踪进程存在;应通过 PID 验证
  • 当服务器无法启动时,日志没有帮助;改进错误诊断
  • 客户端误解 expoLogs 用法,导致错误的假设和不必要的重启
  • 应从持久化的日志文件中查询日志,而不是内存中的子进程事件,以提高鲁棒性
  • npm run start 有时无法终止

使用教程

使用依赖

npm install

安装教程

npm run build
npm start

调试方式

npm run dev
npm run inspect

许可证

该项目遵循 MIT 开源许可条款。