react-native-mcp-kit 1.0.0

package/dist/server/mcpServer.js

@@ -0,0 +1,303 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpServerWrapper = void 0;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_1 = require("zod");
+const protocol_1 = require("../shared/protocol");
+const BASE_INSTRUCTIONS = `You are connected to a running React Native app via the react-native-mcp-kit bridge.
+
+## How to interact
+
+1. Use \`connection_status\` to check if the app is connected
+2. Use \`list_tools\` to see all available tools with descriptions and examples
+3. Use \`call\` to invoke any tool with format: module${protocol_1.MODULE_SEPARATOR}method (e.g. navigation${protocol_1.MODULE_SEPARATOR}navigate)
+4. Use \`state_list\` / \`state_get\` to read app state exposed by the developer
+`;
+class McpServerWrapper {
+    bridge;
+    dynamicTools = new Map();
+    mcp;
+    modules = [];
+    stateStore = new Map();
+    constructor(bridge) {
+        this.bridge = bridge;
+        this.mcp = new mcp_js_1.McpServer({ name: 'react-native-mcp-kit', version: '1.0.0' }, { instructions: BASE_INSTRUCTIONS });
+        this.registerTools();
+    }
+    addDynamicTool(module, name, description) {
+        this.dynamicTools.set(`${module}${protocol_1.MODULE_SEPARATOR}${name}`, { description, module });
+    }
+    removeDynamicTool(module, name) {
+        this.dynamicTools.delete(`${module}${protocol_1.MODULE_SEPARATOR}${name}`);
+    }
+    setModules(modules) {
+        this.modules = modules;
+    }
+    setState(key, value) {
+        this.stateStore.set(key, value);
+    }
+    removeState(key) {
+        this.stateStore.delete(key);
+    }
+    async start() {
+        const transport = new stdio_js_1.StdioServerTransport();
+        await this.mcp.connect(transport);
+    }
+    registerTools() {
+        this.mcp.registerTool('call', {
+            annotations: {
+                openWorldHint: true,
+                title: 'Call Tool',
+            },
+            description: 'Call a tool registered by the React Native app. Use list_tools first to see available tools.',
+            inputSchema: {
+                args: zod_1.z
+                    .string()
+                    .optional()
+                    .describe('Arguments as JSON string (e.g. {"screen": "AUTH_LOGIN_SCREEN"})'),
+                tool: zod_1.z
+                    .string()
+                    .describe(`Tool name in format "module${protocol_1.MODULE_SEPARATOR}method" (e.g. "navigation${protocol_1.MODULE_SEPARATOR}navigate")`),
+            },
+        }, async ({ args, tool }) => {
+            if (!this.bridge.isClientConnected()) {
+                return {
+                    content: [
+                        {
+                            text: JSON.stringify({ error: 'React Native app is not connected' }),
+                            type: 'text',
+                        },
+                    ],
+                };
+            }
+            // Find the module by matching prefix
+            let mod;
+            let moduleName = '';
+            let methodName = '';
+            for (const m of this.modules) {
+                const prefix = `${m.name}${protocol_1.MODULE_SEPARATOR}`;
+                if (tool.startsWith(prefix)) {
+                    mod = m;
+                    moduleName = m.name;
+                    methodName = tool.slice(prefix.length);
+                    break;
+                }
+            }
+            // If no module matched, check for dynamic tool prefix
+            if (!mod) {
+                if (tool.startsWith(protocol_1.DYNAMIC_PREFIX)) {
+                    moduleName = `${protocol_1.MODULE_SEPARATOR}dynamic`;
+                    methodName = tool.slice(protocol_1.DYNAMIC_PREFIX.length);
+                }
+                else {
+                    const idx = tool.indexOf(protocol_1.MODULE_SEPARATOR);
+                    if (idx <= 0) {
+                        return {
+                            content: [
+                                {
+                                    text: JSON.stringify({
+                                        error: `Invalid tool name "${tool}". Use "module${protocol_1.MODULE_SEPARATOR}method" format.`,
+                                    }),
+                                    type: 'text',
+                                },
+                            ],
+                        };
+                    }
+                    moduleName = tool.slice(0, idx);
+                    methodName = tool.slice(idx + protocol_1.MODULE_SEPARATOR.length);
+                }
+            }
+            let parsedArgs = {};
+            if (args) {
+                try {
+                    parsedArgs = JSON.parse(args);
+                }
+                catch {
+                    return {
+                        content: [
+                            { text: JSON.stringify({ error: 'Invalid JSON in args' }), type: 'text' },
+                        ],
+                    };
+                }
+            }
+            if (!mod) {
+                // No module matched — try as dynamic tool via bridge
+                try {
+                    const result = await this.bridge.call(moduleName, methodName, parsedArgs);
+                    return { content: this.formatResult(result) };
+                }
+                catch {
+                    const allModules = this.modules
+                        .map((m) => {
+                        return m.name;
+                    })
+                        .join(', ');
+                    const dynNames = [...this.dynamicTools.keys()].join(', ');
+                    return {
+                        content: [
+                            {
+                                text: JSON.stringify({
+                                    error: `Tool "${tool}" not found. Modules: ${allModules}. Dynamic: ${dynNames || 'none'}`,
+                                }),
+                                type: 'text',
+                            },
+                        ],
+                    };
+                }
+            }
+            const toolDef = mod.tools.find((t) => {
+                return t.name === methodName;
+            });
+            if (!toolDef) {
+                return {
+                    content: [
+                        {
+                            text: JSON.stringify({
+                                error: `Tool "${methodName}" not found in module "${moduleName}". Available: ${mod.tools
+                                    .map((t) => {
+                                    return t.name;
+                                })
+                                    .join(', ')}`,
+                            }),
+                            type: 'text',
+                        },
+                    ],
+                };
+            }
+            const result = await this.bridge.call(moduleName, methodName, parsedArgs, toolDef.timeout);
+            return { content: this.formatResult(result) };
+        });
+        this.mcp.registerTool('list_tools', {
+            annotations: {
+                readOnlyHint: true,
+                title: 'List Tools',
+            },
+            description: 'List all tools registered by the React Native app, grouped by module',
+        }, async () => {
+            if (!this.bridge.isClientConnected()) {
+                return {
+                    content: [
+                        {
+                            text: JSON.stringify({
+                                connected: false,
+                                error: 'React Native app is not connected',
+                            }),
+                            type: 'text',
+                        },
+                    ],
+                };
+            }
+            const moduleTools = this.modules.map((mod) => {
+                return {
+                    description: mod.description,
+                    module: mod.name,
+                    tools: mod.tools.map((t) => {
+                        return {
+                            description: t.description,
+                            inputSchema: t.inputSchema,
+                            name: `${mod.name}${protocol_1.MODULE_SEPARATOR}${t.name}`,
+                        };
+                    }),
+                };
+            });
+            // Add dynamic tools (from useMcpTool hooks)
+            if (this.dynamicTools.size > 0) {
+                const dynamicByModule = new Map();
+                for (const [fullName, info] of this.dynamicTools) {
+                    const existing = dynamicByModule.get(info.module) ?? [];
+                    existing.push({
+                        description: info.description,
+                        inputSchema: undefined,
+                        name: fullName,
+                    });
+                    dynamicByModule.set(info.module, existing);
+                }
+                for (const [module, dynTools] of dynamicByModule) {
+                    moduleTools.push({
+                        description: 'Dynamically registered tools from useMcpTool hooks',
+                        module: `${module} (dynamic)`,
+                        tools: dynTools,
+                    });
+                }
+            }
+            return {
+                content: [{ text: JSON.stringify(moduleTools, null, 2), type: 'text' }],
+            };
+        });
+        this.mcp.registerTool('connection_status', {
+            annotations: {
+                readOnlyHint: true,
+                title: 'Connection Status',
+            },
+            description: 'Check if the React Native app is connected',
+        }, async () => {
+            return {
+                content: [
+                    {
+                        text: JSON.stringify({
+                            connected: this.bridge.isClientConnected(),
+                            modules: this.modules.map((m) => {
+                                return m.name;
+                            }),
+                        }),
+                        type: 'text',
+                    },
+                ],
+            };
+        });
+        this.mcp.registerTool('state_get', {
+            annotations: {
+                readOnlyHint: true,
+                title: 'Get State',
+            },
+            description: 'Read a state value exposed by the React Native app via useMcpState',
+            inputSchema: {
+                key: zod_1.z.string().describe('State key to read (e.g. "cart", "auth")'),
+            },
+        }, async ({ key }) => {
+            const value = this.stateStore.get(key);
+            if (value === undefined) {
+                return {
+                    content: [
+                        {
+                            text: JSON.stringify({
+                                error: `State "${key}" not found. Use state_list to see available keys.`,
+                            }),
+                            type: 'text',
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [{ text: JSON.stringify(value, null, 2), type: 'text' }],
+            };
+        });
+        this.mcp.registerTool('state_list', {
+            annotations: {
+                readOnlyHint: true,
+                title: 'List State',
+            },
+            description: 'List all available state keys exposed by the React Native app',
+        }, async () => {
+            const keys = Array.from(this.stateStore.keys());
+            return {
+                content: [{ text: JSON.stringify({ keys }, null, 2), type: 'text' }],
+            };
+        });
+    }
+    formatResult(result) {
+        if (Array.isArray(result) && result.length > 0) {
+            const first = result[0];
+            if (typeof first === 'object' &&
+                first !== null &&
+                'type' in first &&
+                first.type === 'image') {
+                return result;
+            }
+        }
+        return [{ text: JSON.stringify(result, null, 2), type: 'text' }];
+    }
+}
+exports.McpServerWrapper = McpServerWrapper;
+//# sourceMappingURL=mcpServer.js.map

package/dist/server/mcpServer.js.map

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

package/dist/server/types.d.ts

@@ -0,0 +1,12 @@
+import { type ModuleDescriptor, type ModuleToolDescriptor } from '../shared/protocol';
+export interface BridgeEvents {
+    onRegistration: (modules: ModuleDescriptor[]) => void;
+    onStateRemove: (key: string) => void;
+    onStateUpdate: (key: string, value: unknown) => void;
+    onToolRegister: (module: string, tool: ModuleToolDescriptor) => void;
+    onToolUnregister: (module: string, toolName: string) => void;
+}
+export interface ServerConfig {
+    port?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAErF,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,IAAI,CAAC;IACtD,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACrD,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACrE,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9D;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/server/types.js

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

package/dist/server/types.js.map

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

package/dist/shared/protocol.d.ts

@@ -0,0 +1,54 @@
+/** Separator between module name and tool name in MCP call format */
+export declare const MODULE_SEPARATOR = "__";
+/** Prefix for dynamic tools registered via useMcpTool */
+export declare const DYNAMIC_PREFIX = "__dynamic__";
+export interface ModuleToolDescriptor {
+    description: string;
+    name: string;
+    inputSchema?: Record<string, unknown>;
+    timeout?: number;
+}
+export interface ModuleDescriptor {
+    name: string;
+    tools: ModuleToolDescriptor[];
+    description?: string;
+}
+export interface RegistrationMessage {
+    modules: ModuleDescriptor[];
+    type: 'registration';
+}
+export interface ToolRequest {
+    args: Record<string, unknown>;
+    id: string;
+    method: string;
+    module: string;
+    type: 'tool_request';
+}
+export interface ToolResponse {
+    id: string;
+    type: 'tool_response';
+    error?: string;
+    result?: unknown;
+}
+export interface StateUpdateMessage {
+    key: string;
+    type: 'state_update';
+    value: unknown;
+}
+export interface StateRemoveMessage {
+    key: string;
+    type: 'state_remove';
+}
+export interface ToolRegisterMessage {
+    module: string;
+    tool: ModuleToolDescriptor;
+    type: 'tool_register';
+}
+export interface ToolUnregisterMessage {
+    module: string;
+    toolName: string;
+    type: 'tool_unregister';
+}
+export type ClientMessage = RegistrationMessage | StateRemoveMessage | StateUpdateMessage | ToolRegisterMessage | ToolResponse | ToolUnregisterMessage;
+export type ServerMessage = ToolRequest;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/shared/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/shared/protocol.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,yDAAyD;AACzD,eAAO,MAAM,cAAc,gBAAkD,CAAC;AAI9E,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,IAAI,EAAE,cAAc,CAAC;CACtB;AAID,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;CACtB;AAID,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAID,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,cAAc,CAAC;CACtB;AAID,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,oBAAoB,CAAC;IAC3B,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAID,MAAM,MAAM,aAAa,GACrB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,mBAAmB,GACnB,YAAY,GACZ,qBAAqB,CAAC;AAE1B,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC"}

package/dist/shared/protocol.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DYNAMIC_PREFIX = exports.MODULE_SEPARATOR = void 0;
+/** Separator between module name and tool name in MCP call format */
+exports.MODULE_SEPARATOR = '__';
+/** Prefix for dynamic tools registered via useMcpTool */
+exports.DYNAMIC_PREFIX = `${exports.MODULE_SEPARATOR}dynamic${exports.MODULE_SEPARATOR}`;
+//# sourceMappingURL=protocol.js.map

package/dist/shared/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/shared/protocol.ts"],"names":[],"mappings":";;;AAAA,qEAAqE;AACxD,QAAA,gBAAgB,GAAG,IAAI,CAAC;AAErC,yDAAyD;AAC5C,QAAA,cAAc,GAAG,GAAG,wBAAgB,UAAU,wBAAgB,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "react-native-mcp-kit",
+  "version": "1.0.0",
+  "description": "Bidirectional MCP bridge connecting AI agents to running React Native apps",
+  "license": "MIT",
+  "author": "Aliaksei Pranko",
+  "homepage": "https://github.com/pranko17/react-native-mcp-kit#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pranko17/react-native-mcp-kit.git"
+  },
+  "keywords": [
+    "ai",
+    "ai-testing",
+    "agent",
+    "automation",
+    "claude",
+    "debugging",
+    "devtools",
+    "fiber",
+    "inspection",
+    "mcp",
+    "model-context-protocol",
+    "react-native",
+    "rn",
+    "screenshot",
+    "testing"
+  ],
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "react-native-mcp-kit": "dist/server/cli.js"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./client": "./dist/client/index.js",
+    "./modules": "./dist/modules/index.js",
+    "./babel": "./dist/babel/index.js",
+    "./babel/test-id-plugin": "./dist/babel/testIdPlugin.js",
+    "./babel/strip-plugin": "./dist/babel/stripPlugin.js",
+    "./server": "./dist/server/index.js"
+  },
+  "scripts": {
+    "build": "tsc && tsc-alias",
+    "dev": "tsc --watch",
+    "lint": "eslint --ext .ts --ext .tsx ./src",
+    "lint:fix": "eslint --ext .ts --ext .tsx ./src --fix",
+    "lint:ts": "tsc --noEmit"
+  },
+  "packageManager": "yarn@1.22.22+sha1.ac34549e6aa8e7ead463a7407e1c7390f61a6610",
+  "devDependencies": {
+    "@babel/core": "^7.29.0",
+    "@types/babel__core": "^7.20.5",
+    "@types/node": "^25.5.2",
+    "@types/react": "^19.2.14",
+    "@types/ws": "^8.18.1",
+    "@typescript-eslint/eslint-plugin": "^8.48.0",
+    "@typescript-eslint/parser": "^8.48.0",
+    "eslint": "^8.57.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-import-resolver-alias": "^1.1.2",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-prettier": "^5.5.5",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-sort-destructure-keys": "^3.0.0",
+    "eslint-plugin-sort-keys-fix": "^1.1.2",
+    "eslint-plugin-typescript-sort-keys": "^3.3.0",
+    "prettier": "^3.8.1",
+    "tsc-alias": "^1.8.16",
+    "typescript": "~5.7.0"
+  },
+  "peerDependencies": {
+    "@shopify/react-native-skia": ">=1.0",
+    "react": ">=19"
+  },
+  "peerDependenciesMeta": {
+    "@shopify/react-native-skia": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "ws": "^8.20.0",
+    "zod": "^4.3.6"
+  }
+}