wiretap-mcp 2.0.0

package/dist/types.d.ts

@@ -0,0 +1,123 @@
+export type LogSeverity = "error" | "warn" | "info" | "debug";
+export interface TerminalLogEntry {
+    id: number;
+    timestamp: string;
+    severity: LogSeverity;
+    message: string;
+    raw: string;
+    source: "metro" | "expo" | "react-native" | "unknown";
+    stackTrace?: string;
+    isNativeCrash?: boolean;
+}
+export interface ReactotronLogEntry {
+    id: number;
+    timestamp: string;
+    type: "log" | "api" | "state" | "asyncStorage" | "benchmark" | "custom" | "display";
+    name?: string;
+    payload: unknown;
+    important?: boolean;
+    duration?: number;
+}
+export interface ApiCallEntry {
+    id: number;
+    timestamp: string;
+    method: string;
+    url: string;
+    status?: number;
+    duration?: number;
+    requestHeaders?: Record<string, string>;
+    requestBody?: unknown;
+    responseHeaders?: Record<string, string>;
+    responseBody?: unknown;
+}
+export interface StateChangeEntry {
+    id: number;
+    timestamp: string;
+    store: string;
+    action: string;
+    path?: string;
+    before?: unknown;
+    after?: unknown;
+}
+export interface PerformanceEntry {
+    id: number;
+    timestamp: string;
+    title: string;
+    duration: number;
+    steps?: {
+        title: string;
+        duration: number;
+    }[];
+}
+export interface HermesLogEntry {
+    id: number;
+    timestamp: string;
+    level: LogSeverity;
+    message: string;
+    args?: unknown[];
+    stackTrace?: string;
+    source: "hermes";
+    url?: string;
+    lineNumber?: number;
+}
+export interface NetworkEntry {
+    id: number;
+    timestamp: string;
+    requestId: string;
+    method: string;
+    url: string;
+    status?: number;
+    mimeType?: string;
+    requestHeaders?: Record<string, string>;
+    responseHeaders?: Record<string, string>;
+    duration?: number;
+    source: "cdp";
+}
+export interface CrashLogEntry {
+    id: number;
+    timestamp: string;
+    platform: "ios" | "android";
+    processName: string;
+    crashReason: string;
+    exceptionType?: string;
+    signal?: string;
+    stackTrace: string;
+    rawFilePath?: string;
+}
+export interface AppStatus {
+    metroRunning: boolean;
+    reactotronConnected: boolean;
+    hermesConnected: boolean;
+    detectedProcess: string | null;
+    errorCount: number;
+    warningCount: number;
+    lastCrash: TerminalLogEntry | CrashLogEntry | null;
+    uptime: number;
+    terminalLogCount: number;
+    reactotronLogCount: number;
+    hermesLogCount: number;
+    networkCallCount: number;
+    crashCount: number;
+    iosCrashMonitorActive: boolean;
+    androidCrashMonitorActive: boolean;
+}
+export interface CompanionConfig {
+    reactotronPort: number;
+    terminalLogBufferSize: number;
+    reactotronLogBufferSize: number;
+    autoDetectTerminal: boolean;
+    watchPaths: string[];
+    filterPatterns: string[];
+    persistLogs: boolean;
+    persistPath: string;
+    persistFlushIntervalMs: number;
+    persistMaxEntriesOnLoad: number;
+    hermesEnabled: boolean;
+    metroPort: number;
+    cdpCaptureNetwork: boolean;
+    iosCrashMonitorEnabled: boolean;
+    iosCrashReportPath: string;
+    androidCrashMonitorEnabled: boolean;
+    adbPath: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "wiretap-mcp",
+  "version": "2.0.0",
+  "description": "MCP Server — Real-time React Native debugging for Claude Code. Terminal logs, Hermes/CDP runtime, network inspector, Reactotron integration, iOS/Android crash reports.",
+  "author": "Jaqueline Gonzaga <jaqueline_gonzaga@hotmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gonzagajaque/wiretap-mcp.git"
+  },
+  "homepage": "https://github.com/gonzagajaque/wiretap-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/gonzagajaque/wiretap-mcp/issues"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "wiretap-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "scripts/install.sh",
+    "wiretap.config.json",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "install-mcp": "bash scripts/install.sh",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "wiretap",
+    "mcp",
+    "model-context-protocol",
+    "react-native",
+    "reactotron",
+    "hermes",
+    "cdp",
+    "chrome-devtools-protocol",
+    "debug",
+    "debugging",
+    "claude-code",
+    "claude",
+    "ai",
+    "network-inspector",
+    "crash-reports",
+    "metro",
+    "expo"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.0",
+    "@types/ws": "^8.5.14",
+    "typescript": "^5.7.3"
+  }
+}

package/scripts/install.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+
+echo "==> Installing dependencies..."
+cd "$PROJECT_DIR"
+npm install
+
+echo "==> Building project..."
+npm run build
+
+echo "==> Registering MCP server in Claude Code..."
+claude mcp add rn-dev-companion -- node "$PROJECT_DIR/dist/index.js"
+
+echo ""
+echo "Done! rn-dev-companion MCP server installed."
+echo "Restart Claude Code to use the new tools."
+echo ""
+echo "Available tools (12):"
+echo "  - get_terminal_logs    Get Metro/Expo terminal logs"
+echo "  - get_reactotron_logs  Get Reactotron logs"
+echo "  - get_hermes_logs      Get JS runtime logs from Hermes/CDP"
+echo "  - get_network_calls    Get HTTP network calls via CDP"
+echo "  - get_errors           Get consolidated errors/crashes"
+echo "  - get_api_calls        Get API calls from Reactotron"
+echo "  - get_state_changes    Get state changes from Reactotron"
+echo "  - get_native_crashes   Get native crash reports (iOS/Android)"
+echo "  - get_app_status       Get overall app status"
+echo "  - get_performance      Get performance metrics"
+echo "  - search_logs          Full-text search across all logs"
+echo "  - clear_logs           Clear all log buffers"

package/wiretap.config.json

@@ -0,0 +1,8 @@
+{
+  "reactotronPort": 9090,
+  "terminalLogBufferSize": 500,
+  "reactotronLogBufferSize": 500,
+  "autoDetectTerminal": true,
+  "watchPaths": [],
+  "filterPatterns": []
+}