Expo Metro MCP

MCP开发工具

提供方 Synnode

开发工具 未标注 无需鉴权 社区 / 第三方 Claude

连接Expo/Metro开发服务器并暴露日志给Claude Code的工具,支持日志管理、运行时评估、UI自动化等功能。适用于React Native开发调试。

一句话选型结论

按资料字段整理

Expo Metro MCP 属于开发工具类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 26 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量26暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

ReactNative开发TypeScript本地部署日志管理调试工具UI自动化运行时评估

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 26 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 26 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Expo Metro MCP当前 26 未标注 未标注 无 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Synnode上游标注的维护方 Synnode
分类开发工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.8 KB
来自项目仓库与上游目录的原文,未做删改

@synnode/expo地铁mcp

MCP服务器,连接到正在运行的Expo/Metro开发服务器,并将其日志暴露给Claude Code。

使用 Chrome DevTools协议(CDP) Metro公开的检查器端点——与React Native DevTools使用的通道相同。与Expo SDK 50+兼容,包括新架构(无桥/JSI)。

安装```bash

Register with Claude Code CLI

claude mcp add expo-metro npx @synnode/expo-metro-mcp


或者全局安装并注册:```bash
npm install -g @synnode/expo-metro-mcp
claude mcp add expo-metro expo-metro-mcp

添加服务器后重新启动Claude Code。

需求

  • Expo/Metro开发服务器正在运行(npx expo start)
  • 连接到Metro的设备或模拟器(应用程序必须正在运行才能显示日志)

配置```bash

Defaults — only override if needed

METRO_PORT=8081
METRO_HOST=localhost
LOG_BUFFER_SIZE=1000


如果Metro在其他端口上运行:```bash
claude mcp add expo-metro --env METRO_PORT=8082 npx @synnode/expo-metro-mcp

可用工具

工具 说明
get_logs 缓冲区中的最新日志。可选: lines, level (error/warn/info/log/debug), since (例如。 "30s", "2m",unix时间戳)
get_errors 缓冲区堆栈跟踪错误。可选: lines
get_status 连接状态、设备名称和缓冲区统计信息
clear_logs 清除日志缓冲区
watch_logs 轮询时间窗口内的传入日志。可选: duration (例如。 "10s",最大值 "30s"), level
connect 从Metro获取CDP连接。使用后 disconnect 或者当 get_status 显示已断开连接
disconnect 释放CDP连接,以便React Native DevTools可以自由连接
reload 通过Metro重新加载React Native应用程序
resolve_stack 根据Metro源代码映射解析堆栈跟踪,显示原始文件/行而不是包偏移量
list_devices 列出活动的iOS模拟器和Android模拟器
screenshot 截取活动模拟器/仿真器的屏幕截图。返回图像+像素尺寸。可选: platform, device_id
tap 点击活动模拟器/仿真器上的x、y坐标。可选: platform, device_id
swipe 从一个坐标滑动到另一个坐标。可选: duration_ms, platform, device_id
input_text 在焦点输入字段中键入文本——无需屏幕键盘即可使用。可选: platform, device_id
input_key 发送一个特殊按键: enter, backspace, delete, tab, escape, back, space,箭头键。可选: platform, device_id
evaluate 通过Metro CDP在连接的应用运行时运行JavaScript。支持异步表达式。可用于读取状态、调用应用程序帮助程序、戳导航或更改调试状态。可选: timeout_ms
mmkv_get 从仅用于开发的MMKV调试挂钩中读取原始字符串值 globalThis.__EXPO_METRO_MCP__.mmkv
mmkv_set 通过MMKV调试挂钩写入原始字符串值
mmkv_remove 通过MMKV调试挂钩删除密钥
mmkv_keys 列出通过MMKV调试挂钩可用的所有密钥
mmkv_get_json 读取并解析JSON值的MMKV条目
mmkv_set_json 将任何JSON可序列化值存储在MMKV中,无需手动字符串化
mmkv_merge_json 将对象浅合并到现有的JSON值MMKV条目中
zustand_persist_get 读取持久的Zustand MMKV有效载荷并拆分 state 和 version
zustand_persist_set 在中写入持久的Zustand有效载荷 { state, version? } 形状
zustand_persist_merge 将字段合并到现有的持久Zustand中 state 对象

运行时评估

evaluate 通过CDP直接在连接的React Native应用运行时运行JavaScript Runtime.evaluate.

它有什么好处:

  • 检查全局、存储和导航状态
  • 调用调试助手或导出函数
  • 通过应用程序的JS运行时读取或写入应用程序持久性
  • 调试期间切换功能标志或临时状态
  • 在不重建UI自动化流程的情况下验证假设

笔记:

  • 表达式会自动等待,因此 Promise 结果开箱即用
  • 返回值在可能的情况下被序列化;不可序列化的对象会回退到其运行时描述
  • 这是一个锋利的工具。非常适合发展,被错误的人诅咒

MMKV调试挂钩

如果你的应用程序使用 react-native-mmkv,您可以公开一个仅限开发人员的小钩子,让MCP种子或检查持久状态,而无需手写eval代码段。

应用程序侧钩示例:```ts
import {createMMKV} from "react-native-mmkv";

export const mmkv = createMMKV({
id: "synorga-app",
});

if (DEV) {
globalThis.EXPO_METRO_MCP = {
...globalThis.EXPO_METRO_MCP,
mmkv: {
id: "synorga-app",
getItem: (key: string) => mmkv.getString(key) ?? null,
setItem: (key: string, value: string) => mmkv.set(key, value),
removeItem: (key: string) => mmkv.remove(key),
getAllKeys: () => mmkv.getAllKeys(),
},
};
}


一旦暴露,MCP可以使用:

- 低级MMKV工具: `mmkv_get`, `mmkv_set`, `mmkv_remove`, `mmkv_keys`
- JSON助手: `mmkv_get_json`, `mmkv_set_json`, `mmkv_merge_json`
- 状态助手: `zustand_persist_get`, `zustand_persist_set`, `zustand_persist_merge`

这有意保持通用性,因此它适用于持久的Zustand状态和普通的MMKV使用,而无需将MCP耦合到您的存储内部。

对于大多数人工智能驱动的状态播种,Zustand助手是最佳选择。他们每次都避免手工构建持久的包装形状。

## 屏幕截图和UI自动化

`screenshot`, `tap`, `swipe`, `input_text`,以及 `input_key` 直接与您的跑步模拟器或仿真器交互,无需额外的软件包或付费计划。

**要求:**

- **iOS屏幕截图**:安装了Xcode的macOS(`xcrun simctl` 必须可用)
- **iOS点击/滑动/输入**: `idb` --Facebook的iOS开发桥梁```bash
brew tap facebook/fb && brew install idb-companion
pip3 install fb-idb
  • 安卓: adb 在您的PATH(Android SDK平台工具的一部分)中,所有工具都可以开箱即用

笔记:

  • screenshot 返回图像及其像素尺寸——直接使用这些坐标 tap/swipe,无需手动缩放
  • input_text 在不需要屏幕键盘出现的情况下,在焦点字段中键入
  • 填写表格: tap 领域→ input_text 价值→ input_key "enter" 提交
  • 如果多个设备正在运行,请使用 list_devices 找到ID并通过 device_id
  • iOS屏幕截图无需idb即可使用——只需点击/滑动/输入即可

与React Native DevTools一起使用

CDP一次只允许一个客户端。MCP和DevTools之间的切换是无缝的——最后一个连接接管,另一个自动被踢出。

  • 使用DevTools:只需打开或重新连接即可。MCP将自动断开连接。
  • 返回MCP:呼叫 connectDevTools将失去连接。

disconnect 如果你想先显式释放连接,它是可用的,但这不是必需的。

get_status 始终显示MCP当前是否已连接。

运作原理

Metro在以下位置公开了CDP WebSocket /inspector/debug.On connect,服务器调用 /json/list 发现活动设备目标,然后通过CDP连接并启用 Runtime.consoleAPICalled 事件。Metro构建错误(build_failed, bundling_error)通过单独捕获 /events WebSocket,自动重新连接。

教授Claude代码关于此MCP

添加 SKILL.md 到您的项目根(或 CLAUDE.md)教Claude Code如何有效地使用此MCP——何时检查日志、如何调试错误、如何使用屏幕截图和点击等等。bash curl -o SKILL.md https://raw.githubusercontent.com/Synnode/expo-metro-mcp/master/SKILL.md

备注

  • 如果启动时无法访问Metro:服务器正常启动, get_status 回报 connected: false.致电 connect 一旦你的开发服务器启动。
  • 记忆受到以下因素的限制 LOG_BUFFER_SIZE (循环缓冲区,最旧的条目先删除)。
  • CDP连接可能会在Metro的终端中显示“不受支持的调试客户端”通知——这是无害的。

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Expo Metro MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Expo Metro MCP 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Expo Metro MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Expo Metro MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Expo Metro MCP 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Expo Metro MCP 能提供哪些能力?

资料显示约 26 个工具;能力标签包括 调试工具、TypeScript、Claude、日志管理。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。