faker

This MCP server exposes a set of tools for generating fake data using Faker.js. It supports multiple data generation modules such as generate_person, generate_lorem, generate_internet, generate_date, and generate_commerce, among others. You can customize output by selecting the data type and adjusting parameters like length, count, or locale to suit your testing or seeding needs. The server is TypeScript-based and built to demonstrate MCP concepts, including how to expose modular tools that can be composed or configured via the MCP protocol. To use it, run the server and connect via the MCP client tooling, then issue requests for the specific generator you want (e.g., person data with locale en, or internet data with a given length). Locally, you can switch locales (en, ja, fr, etc.) to generate locale-specific fake data.

Typical workflows include: requesting generate_person to obtain names and job titles, using generate_lorem for placeholder text, and using generate_internet for emails, usernames, and URLs. You can also combine parameters (like count and length) to generate multiple records in one call. The server exposes various modules from Faker.js, giving you access to a wide range of fake data types suitable for mock APIs, testing environments, or UI demos.

Prerequisites:

• Node.js (v14+ recommended) and npm installed
• A working MCP-enabled environment to consume the server

Installation steps:

1. Clone or download the repository for faker-server.
2. Install dependencies: npm install
3. Build the server (transpile TypeScript to JavaScript): npm run build
4. (Optional) Start in watch/development mode for auto-rebuilds: npm run watch

Usage after installation:

• Run the server (if not using a launcher that starts it automatically): npm run build && node build/index.js
• Confirm the server is listening via stdio or logs, depending on your MCP host integration.
• Ensure you connect via the MCP protocol to request the available generation tools (generate_person, generate_lorem, generate_internet, etc.).

Tips and notes:

• The server supports multiple Faker locales; specify locale parameters as needed to generate locale-specific data (e.g., en, ja, fr).
• Tools include generate_person, generate_lorem, generate_internet, generate_date, generate_commerce, and more from Faker.js; refer to the generated tool list in your MCP client for available endpoints.
• This MCP server uses TypeScript; ensure the build step completes successfully to produce the runnable index.js (build/index.js).
• Debugging MCP servers can be challenging since they communicate over stdio. You can use the MCP Inspector tool to help attach to the server and inspect protocol exchanges.
• If integrating with Claude Desktop, update your claude_desktop_config.json with the server entry and the correct path to your built index.js.