faker

The Faker MCP Server provides a set of MCP-compatible tools to generate realistic fake data using Faker.js. It exposes four primary data generation tools: generate-person, generate-company, generate-dataset, and generate-custom. These tools allow you to rapidly create structured, locale-aware seed data for testing, demos, and development environments. You can request data via MCP protocol calls and receive JSON payloads that include person records, company records, or more complex interconnected datasets with referential integrity. The server supports reproducible results through seeding and can generate data across multiple locales including en, fr, de, es, and ja.

To use the tools, point your MCP client to the faker server and call the specific tool by name with an arguments object that matches the parameters described in the README. For example, you can request generate-person to create a batch of people with optional address, phone, and date-of-birth fields, or use generate-dataset to build multi-entity datasets with defined relationships. If you need highly customized data, generate-custom lets you specify patterns for fields such as regex patterns, enums, formats, or numeric ranges. All responses are standard JSON, designed to be easy to consume by testing scripts, data pipelines, or agent workflows.

Common workflows include seed-based generation for reproducible test runs, locale-specific data for internationalization testing, and high-volume data generation to stress-test APIs and databases. The server is MCP Protocol Compliant, so it plugs into any MCP client alongside other MCP-enabled services without bespoke adapters.

Prerequisites:

• Node.js 18+ installed on your system
• An MCP-compatible client (e.g., Claude Desktop, Cline, Cursor or any MCP client)

Installation steps:

1. Install Node.js 18+ from the official Node.js website or via your preferred package manager.
2. Install or pull the Faker MCP Server package (the npm package is typically named faker-mcp-server).
3. Run the server using an MCP client configuration or via npx as shown below.

Example setup:

• Using npx (recommended for quick starts):

  • Ensure you have npm installed. Then run:

    npx faker-mcp-server
    

• If you want to pin a specific version:

  npx faker-mcp-server@1.0.0
  

• If you prefer a local development install:

  npm install -g faker-mcp-server
  faker-mcp-server
  

Configuration example (MCP client config):

{
  "mcpServers": {
    "faker": {
      "command": "npx",
      "args": ["faker-mcp-server"]
    }
  }
}

Tip: Check the README of the faker-mcp-server package for any environment-variable requirements or extra flags.

Notes and tips:

• Locale support: Generate-person and generate-company support locales: en, fr, de, es, ja. Use the locale parameter to tailor names, addresses, and data patterns.
• Seeding: Use seed to obtain reproducible results across runs.
• Performance: The server is designed for high throughput (seed and batch options help maximize efficiency for large datasets).
• Data shapes: Use generate-dataset to create complex datasets with multiple entities and referential integrity. You can define relationships and optional nullability.
• Patterns: generate-custom can enforce specific patterns such as regex constraints, enumerations, format templates, or numeric ranges for highly specialized data.
• MCP client compatibility: Since the server is MCP Protocol compliant, it integrates with any MCP-enabled client without requiring custom adapters.
• Troubleshooting: If the server fails to start, verify Node.js is correctly installed (node -v), ensure the npm package is available on your registry, and confirm that port/host configurations (if any) do not conflict with other services.
• Environment variables: If the server exposes environment variables (e.g., for default locale or seed), set them via your deployment environment or MCP client settings as described in the package documentation.