Generate realistic fake test data (people, companies, custom patterns) via faker-mcp-server (npx)

Recipe: Generate fake test data via faker-mcp-server (npx)

Server: [email protected] · npm · stdio Launch: npx -y faker-mcp-server Auth: none Tools (4):

• generate-person — names, emails, phones, addresses, DOB. Up to 10k records. Locales: en/fr/de/es/ja.
• generate-company — company names, industries, websites, addresses. Same scale/locale options.
• generate-dataset — structured dataset with entity relationships (one-to-many, many-to-many). Supports person/company/custom entity types with referential integrity.
• generate-custom — pattern-based fields: regex (e.g. ORD-[0-9]{6}), enum (pick from list), format (locale-aware), range (min/max with precision).

Key feature: seed parameter for deterministic, reproducible output across runs.

Trace 1: generate-person (3 people with seed 42)

// REQUEST
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"generate-person","arguments":{"count":3,"locale":"en","includeAddress":true,"includePhone":true,"includeDateOfBirth":true,"seed":42}}}

// RESPONSE (2ms generation time)
{
  "data": [
    {"id":"person_42_0","firstName":"Garnet","lastName":"Wiegand","fullName":"Garnet Wiegand","email":"[email protected]","phone":"(614) 300-4836 x1760","dateOfBirth":"1930-02-15","address":{"street":"789 Abagail Dam","city":"Clarksville","state":"New Mexico","postalCode":"65040","country":"Faroe Islands"}},
    {"id":"person_42_1","firstName":"Judson","lastName":"Jacobs","fullName":"Judson Jacobs","email":"[email protected]","phone":"(340) 861-3595 x408","dateOfBirth":"1975-11-14","address":{"street":"240 Uriel Views","city":"Minot","state":"South Dakota","postalCode":"30026","country":"Denmark"}},
    {"id":"person_42_2","firstName":"Ignacio","lastName":"Cartwright","fullName":"Ignacio Cartwright","email":"[email protected]","phone":"1-932-367-3452","dateOfBirth":"1970-10-27","address":{"street":"2098 Maple Avenue","city":"High Point","state":"Vermont","postalCode":"57930-5150","country":"Vanuatu"}}
  ],
  "metadata": {"count":3,"seed":42,"locale":"en","generationTimeMs":2}
}

Trace 2: generate-custom (order IDs with regex + enum + range patterns)

// REQUEST
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"generate-custom","arguments":{"count":2,"seed":99,"patterns":{"orderId":{"type":"regex","value":"ORD-[0-9]{6}"},"status":{"type":"enum","value":["pending","shipped","delivered"]},"amount":{"type":"range","value":{"min":10,"max":500,"precision":2}}}}}}

// RESPONSE (2ms generation time)
{
  "data": [
    {"id":"custom_99_0","orderId":"ORD-674887","status":"pending","amount":353.5},
    {"id":"custom_99_1","orderId":"ORD-815925","status":"pending","amount":261.75}
  ],
  "metadata": {"count":2,"patternCount":3,"seed":99,"locale":"en","generationTimeMs":2}
}

Notes

• Server startup via npx takes ~3-5s (cold) due to package install; subsequent invocations reuse cache.
• Generation itself is sub-5ms even for hundreds of records.
• The generate-dataset tool supports relational schemas with foreign keys — useful for seeding test databases with consistent referential integrity.
• Country field in addresses is random worldwide (not limited to locale's country), which is a Faker.js behavior, not a bug.