Generate realistic fake data (persons, companies, datasets, custom patterns) via faker-mcp-server (npx) — 4 tools

faker-mcp-server v1.0.3 — Faker.js mock data generation via MCP

Install: npm install faker-mcp-server Entry: dist/index.js (has shebang, also works as faker-mcp-server bin) Transport: stdio Auth: none

Tools (4)

Key gotchas

1. ⚠️ Data is in `resource` content block, NOT `text` — response has 2 content blocks: {type:"text"} with summary ("Generated 3 person records") and {type:"resource", resource:{uri:"faker://persons/generated", text:"..."}} with the actual JSON data. Parse content[1].resource.text.

1. ⚠️ `format` type in generate-custom is BROKEN — {type:"format", value:"email"} returns literal string "email" not a generated email address. Use generate-person for emails or regex patterns instead.

1. ⚠️ Japanese locale (`ja`) CRASHES — generate-person with locale:"ja" throws -32603: Tool execution failed: The locale data for 'internet.free_email' are missing. Working locales: en, fr, de, es.

1. Dataset relationships declared but NOT materialized — relationships: {department_id: {references: "departments", type: "one-to-many"}} is accepted in schema but employee records have NO department_id field. Custom fields in datasets use faker product/lorem names, not meaningful values.

1. Seed-based determinism WORKS — same seed → identical output, verified across 2 runs with seed:42.

1. 100 records in 2ms — sub-millisecond per record after JIT warmup.

Verified trace (20 calls, 19 OK + 1 correct crash)

generate-person {}
→ ✓ (6ms) 1 record: {id:"person_..._0", firstName:"Josefa", lastName:"Boyle", email:"[email protected]", phone:"1-617-380-5119", address:{street,city,state,postalCode,country}}

generate-person {includeDateOfBirth:true, includeAddress:false, includePhone:false}
→ ✓ (1ms) Fields: id,firstName,lastName,fullName,email,dateOfBirth — address/phone correctly omitted

generate-person {count:3, seed:42} (×2 runs)
→ ✓ DETERMINISTIC: both runs returned identical 3 records — Garnet Wiegand, same email/phone/address

generate-person {locale:"fr", includeDateOfBirth:true}
→ ✓ (1ms) French names/addresses: Nathan Gaillard, phone:+33 731927710, street:"6 Allée de la Pompe"

generate-person {locale:"de"}
→ ✓ (1ms) German: Liz Kulimann, state:"Schleswig-Holstein", street:"Burscheider Str. 294"

generate-person {locale:"es"}
→ ✓ (1ms) Spanish: Emilio Gálvez Bueno, city:"Valladolid", state:"Andalucía"

generate-person {locale:"ja"}
→ ✗ (2ms) MCP error -32603: missing 'internet.free_email' locale data

generate-company {}
→ ✓ (1ms) {name:"Parker Group", industry:"eyeballs", website:"https://used-situation.net/"}

generate-company {includeFoundedYear:true, includeEmployeeCount:true}
→ ✓ (1ms) +founded:1986, +employeeCount:331

generate-company {includeAddress:false, includeWebsite:false, includePhone:false}
→ ✓ (0ms) Minimal: {id, name, industry, email} — 4 fields only

generate-company {locale:"de", includeFoundedYear:true, count:2}
→ ✓ (1ms) German companies: "Rose, Holz und Rüter", phone:"+49-2813-19544218"

generate-custom {patterns:{sku:{type:"regex",value:"SKU-[A-Z]{3}-[0-9]{4}"}, status:{type:"enum",value:["active","inactive","pending"]}, price:{type