e

expo-mcp 模型上下文协议服务器

@mattlemmone/expo-mcp
0 Stars 13 次浏览 mattlemmone 更新于 2026-08-23

一种模型上下文协议服务器,为基于Expo的React Native应用程序提供开发和调试工具,使开发者能够管理Expo服务器、捕获日志以及操作项目文件。

该服务暂未提供标准配置,请参考 README 手动接入

服务介绍

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