expo-mcp 模型上下文协议服务器
一种模型上下文协议服务器,为基于Expo的React Native应用程序提供开发和调试工具,使开发者能够管理Expo服务器、捕获日志以及操作项目文件。
服务介绍
Expo MCP 服务器
一个提供基于 Expo 的 React Native 应用程序开发和调试工具的 Model Context Protocol (MCP) 服务器。该项目集成了日志记录、进程管理和文件工具,以简化自动化和基于 AI 的工作流程。
功能
- 启动、停止和监控 Expo 开发服务器
- 捕获和过滤
stdout/stderr日志 - 读取、写入和列出项目目录中的文件
- 查询日志统计信息并清除日志
- 通过自定义 MCP 工具进行扩展
- 包含用于 AI 处理的打包单文件表示(通过 Repomix)
使用
命令行界面
npm run build
npm start
开发
npm run dev
测试
npm run inspect
可用工具
| 工具名称 | 描述 |
|---|---|
expoStart |
启动 Expo 开发服务器(默认为 iOS) |
expoStop |
停止运行中的 Expo 开发服务器 |
expoStatus |
显示 Expo 服务器的状态和日志 |
expoLogs |
获取最近的 Expo 日志 |
expoGetLogs |
具有高级选项的筛选日志 |
expoLogStats |
当前日志的摘要统计信息 |
expoClearLogs |
清除所有存储的日志 |
readFile |
读取文件内容 |
writeFile |
将内容写入文件 |
listFiles |
列出目录中的文件 |
listTools |
列出服务器中注册的所有工具 |
安装
npm install
构建
npm run build
已知问题 / 待办事项
- MCP 服务器关闭时并不总是终止子 Expo 进程
- 依赖全局状态来跟踪进程存在;应改为通过 PID 验证
- 服务器启动失败时日志没有帮助;需要改进错误诊断
- 客户端误解了
expoLogs的使用方法,导致错误假设和不必要的重启 - 应该从持久化的日志文件而不是内存中的子进程事件查询日志以提高健壮性
npm run start是...无法杀死?
许可证
MIT