pulse-mcp-bridge

An MCP (Model Context Protocol) server that bridges your IDE to a running React Native / Expo mobile app on your local Wi-Fi network, so tools like Claude Code or Cursor can pull live device status, app logs, and a combined standup snapshot (device status + today's git commits).

How it fits together

IDE (MCP client) <--stdio--> pulse-mcp (index.js) <--HTTP--> mobile app (mobile-app-server.js)
                                                         or  <--HTTP--> mock-phone.js (for local testing)

Related MCP server: Expo MCP Server

Setup

npm install

1. Try it locally with the mock phone (no device needed)

In one terminal, start the mock phone server:

node mock-phone.js

This listens on http://localhost:8080 and fakes /status and /logs responses.

2. Register the MCP server with your IDE

See mcp-config.example.json for ready-to-paste config blocks for Cursor, Claude Desktop, and Windsurf. Point MOBILE_PHONE_IP at:

• 127.0.0.1 when testing against mock-phone.js

• your phone's local IP (e.g. 192.168.1.50) when testing against a real device

3. Wire up the real mobile app

Copy mobile-app-server.js into your React Native / Expo app (e.g. src/pulseServer.js) and follow the integration comments at the top of the file:

npm install react-native-http-bridge-refurbished react-native-device-info react-native-view-shot

Then in App.tsx:

import { startPulseServer, setCurrentRoute, recordLog } from "./pulseServer";

useEffect(() => {
  if (__DEV__) startPulseServer();
}, []);

// Anywhere in the app:
recordLog("Synced dashboard data", "success", "SyncService");
recordLog(`Network request failed: ${error.message}`, "error", "NetworkClient");

Make sure your phone and dev machine are on the same Wi-Fi network.

Verified: this integration has been tested end-to-end against a real Expo/React Native app running on the iOS Simulator (Expo SDK 51 / RN 0.74), including a live crash scenario — the bridge correctly goes unreachable when the app stops responding. Android has not been tested yet.

Available MCP tools

Bug-report step recording

Wire a "Start/Stop Recording" toggle in your app to startSessionRecording() / stopSessionRecording(), and call recordStep(...) at any point worth capturing (button taps, network results, errors). When recording stops, a complete report — numbered steps, full logs, and a device/build info snapshot — is auto-saved and instantly queryable via get_bug_report / get_saved_bug_reports. No manual "steps to reproduce" writeup needed.

Environment variables