Metro Mcp
by steve228ukcommunityv0.10.0
38
4
metro-mcp is an MCP server for React Native apps that connects to a running Metro dev server and Hermes via Chrome DevTools Protocol to expose debugging, inspection, automation, and test-recording capabilities. It supports Expo, bare React Native, and other Metro+Hermes projects without requiring app code changes for core features.
From the registry: MCP server for React Native/Expo runtime debugging, inspection, and automation via Metro/CDP
Install & configure
Prerequisites
- requiredNode.js 18+ or Bun 1.0+Node.js 18+ or Bun 1.0+
- requiredReact Native project with MetroA running React Native/Expo app with Metro dev server and Hermes engine
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `metro-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Node.js 18+ or Bun 1.0+** — Node.js 18+ or Bun 1.0+
- **React Native project with Metro** — A running React Native/Expo app with Metro dev server and Hermes engine
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","metro-mcp"]
- optional environment variables:
- `METRO_MCP_PROXY_PORT`: Fixed CDP proxy port (example: `9222`)
- `METRO_MCP_PROXY_ENABLED`: Enable/disable CDP proxy (example: `true`)
Note: Use --port flag for custom Metro port (e.g., 19000 for Expo).
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Use --port flag for custom Metro port (e.g., 19000 for Expo).
Tools (25)
console
Collect and filter console logs
network
Track network requests, inspect response bodies, and view network stats
errors
Collect runtime exceptions and detect Metro bundle errors
evaluate
Execute JavaScript in the app runtime
device
Manage device connection status and reload the app
environment
Inspect build flags, platform constants, environment variables, and Expo config
source
Symbolicate stack traces
redux
Inspect Redux state and dispatch actions
components
Inspect the React component tree
storage
Read AsyncStorage data
simulator
Control iOS simulators and Android devices
deeplink
Test deep links across platforms
permissions
Inspect and manage app permissions on iOS Simulator and Android Emulator
ui-interact
Perform UI automation such as tapping, swiping, and typing
Environment variables
METRO_MCP_PROXY_PORTSets the fixed port used by the built-in CDP proxyMETRO_MCP_PROXY_ENABLEDEnables or disables the built-in CDP proxyPrerequisites
- • Node.js 18+
- • Bun 1.0+
Packages
metro-mcp
npmv0.10.0transport: stdio
Details
- Language
- TypeScript
- License
- MIT
- Released
- Apr 13, 2026
- Last commit
- Apr 22, 2026
- Registry name
- io.github.steve228uk/metro-mcp