mock-data-mcp

Ultra-lightweight mock data generator MCP server. Zero dependencies, bilingual (zh-TW + en).

No SQLite. No API keys. No external services. Just pure JSON in → mock data out.

Install

npm install -g mock-data-mcp

Usage

Claude Desktop / Cursor / OpenCode

Add to your MCP config:

{
  "mcpServers": {
    "mock-data": {
      "command": "npx",
      "args": ["-y", "mock-data-mcp"]
    }
  }
}

Tools

generate — Generate Mock Data

Generate mock data based on a JSON schema. Supports zh-TW (台灣繁體) and en (English).

Input:

{
  "schema": {
    "name": "name",
    "phone": "phone",
    "email": "email",
    "address": "address",
    "age": { "type": "number", "min": 18, "max": 65 },
    "birth_date": { "type": "date", "min": "1960-01-01", "max": "2005-12-31" },
    "user_id": { "type": "string", "prefix": "USR_", "length": 8 },
    "active": "boolean",
    "role": { "type": "options", "options": ["admin", "user", "moderator"] }
  },
  "count": 5,
  "locale": "zh-TW"
}

Output (zh-TW):

[
  {
    "name": "陳志明",
    "phone": "0912345678",
    "email": "[email protected]",
    "address": "100 台北市中正區中山路42 號 3 樓",
    "age": 34,
    "birth_date": "1989-07-15",
    "user_id": "USR_A3k9Xm2P",
    "active": true,
    "role": "admin"
  }
]

Output (en):

[
  {
    "name": "Smith James",
    "phone": "+1-212-555-1234",
    "email": "[email protected]",
    "address": "1234 Main St, Los Angeles, California 90210",
    "age": 28,
    "birth_date": "1995-03-22",
    "user_id": "USR_B7n2Qw5R",
    "active": false,
    "role": "user"
  }
]

types — List Supported Field Types

Returns all supported field types with bilingual descriptions.

Supported Field Types

| Type | zh-TW | en | |------|-------|----| | name | 台灣姓名 | Full name (English) | | phone | 09XXXXXXXX | +1-XXX-XXX-XXXX | | email | Email 地址 | Email address | | address | 完整台灣地址 | US address with ZIP | | company | 台灣公司名稱 | Company name (English) | | job_title | 職稱 | Job title (English) | | id_number | 台灣身份證字號 | US SSN (XXX-XX-XXXX) | | county | 台灣縣市 | US state | | district | 台灣鄉鎮市區 | US city | | uuid | UUID v4 | UUID v4 | | boolean | 布林值 | Boolean | | number | 數字 (需指定 min/max) | Number (specify min/max) | | date | 日期 (需指定 min/max) | Date (specify min/max) | | string | 隨機字串 (可指定 length/prefix) | Random string | | options | 從選項中隨機選擇 | Random from options |

Design

| Feature | Why | |---------|-----| | Zero DB | No SQLite, no setup, instant startup | | Zero API keys | No Gemini, no OpenAI, works offline | | Bilingual data | Built-in zh-TW + en datasets | | Single file | Easy to maintain, easy to audit | | z.any() schema | Flexible field definitions |

License

MIT