metro-mcp-plugin-mmkv

Debug react-native-mmkv storage from metro-mcp.

Quick start

1. Install

npm install --save-dev metro-mcp-plugin-mmkv
# or: yarn add -D metro-mcp-plugin-mmkv

2. Register instances in your app

Call this once at startup, inside a __DEV__ guard (e.g. in your metro-mcp setup file or App.tsx):

import { initializeMMKVMetroMcp } from 'metro-mcp-plugin-mmkv';
import { storage } from './src/utils/storage';

if (__DEV__) {
  initializeMMKVMetroMcp({ default: storage });
}

Pass a name → instance map. Add more entries if you use multiple instances:

initializeMMKVMetroMcp({ default: storage, user: userStorage });

3. Add to metro-mcp.config.ts

import { defineConfig } from 'metro-mcp/plugin';

export default defineConfig({
  plugins: ['metro-mcp-plugin-mmkv'],
});

Tools

| Tool | Description | |------|-------------| | mmkv_list_instances | List registered instance IDs | | mmkv_list_keys | List all keys in an instance | | mmkv_get | Read one key (type auto-detected: string, number, boolean, buffer) | | mmkv_get_all | Dump all keys and values | | mmkv_set | Write a key | | mmkv_delete | Delete a key | | mmkv_clear | Clear an entire instance (requires confirm: true) |

Requirements

• react-native-mmkv v3+
• metro-mcp ≥ 0.9.0