Metro Logs MCP

An MCP (Model Context Protocol) server that captures React Native console logs from Metro bundler, enabling AI assistants like Claude to access app logs without manual copy/paste.

Features

• Captures console.log, console.warn, console.error from React Native apps

• Supports both Expo SDK 54+ (React Native Bridgeless) and RN 0.70+ (Hermes)

• Auto-discovers running Metro servers on common ports

• Filters logs by level (log, warn, error, info, debug)

• Circular buffer stores last 1000 log entries

Requirements

• Node.js 18+

• React Native app running with Metro bundler

Installation

Note: This package is not published to npm. Only local build installation is available.

Option 1: Clone and Build

Option 2: Manual Setup

Copy the source files and build:

Claude Code Setup

Global (all projects)

Project-specific

Manual Configuration

Add to ~/.claude.json (user scope) or .mcp.json (project scope):

Restart Claude Code after adding the configuration.

Available Tools

Usage

1. Start your React Native app:

   npm start # or expo start

2. In Claude Code, scan for Metro:

   Use scan_metro to find and connect to Metro

3. Get logs:

   Use get_logs to see recent console output

Filtering Logs

Available levels: all, log, warn, error, info, debug

Start from Specific Line

This finds the last (most recent) line containing the text and returns logs from that point forward. Useful for getting logs since the last app reload.

Search Logs

Case-insensitive search across all log messages.

Supported React Native Versions

How It Works

1. Fetches device list from Metro's /json endpoint

2. Connects to the main JS runtime via CDP (Chrome DevTools Protocol) WebSocket

3. Enables Runtime.enable to receive Runtime.consoleAPICalled events

4. Stores logs in a circular buffer for retrieval

Troubleshooting

No devices found

• Make sure the app is running on a simulator/device

• Check that Metro bundler is running (npm start)

Wrong device connected

The server prioritizes devices in this order:

1. React Native Bridgeless (SDK 54+)

2. Hermes React Native

3. Any React Native (excluding Reanimated/Experimental)

Logs not appearing

• Ensure the app is actively running (not just Metro)

• Try clear_logs then trigger some actions in the app

• Check get_apps to verify connection status

License

MIT