Faker MCP Server

🚀 Dummy Server MCP Server

A TypeScript-based MCP server that uses Faker.js to generate dummy data. This server demonstrates the core concepts of MCP, including:

• Tools for generating various types of dummy data (people, lorem ipsum, internet, etc.)
• Support for multiple local languages
• Customizable options for each data type

✨ Features

Tools

• generate_person - Generate dummy person data (name, position, etc.)
• generate_lorem - Generate dummy lorem ipsum text
• generate_internet - Generate internet-related dummy data (email, username, URL, etc.)
• generate_date - Generate dummy dates
• generate_commerce - Generate business-related dummy data (products, prices, etc.)
• And many other modules in Faker.js

Functions

• Support for multiple local languages (e.g., en, ja, fr, etc.)
• Customizable field selection for each data type
• Configurable parameters (length, quantity, minimum/maximum values, etc.)

📦 Installation

Install Dependencies

npm install

Build the Server

npm run build

Automatic Rebuild in Development Mode

npm run watch

💻 Usage Examples

Testing

Run All Tests

npm test

Run Tests with Watch

npm run test:watch

Run Specific Integration Tests

npm run test:integration

Generate Test Coverage Report

npm run test:coverage

Installation in Claude Desktop

To use it in Claude Desktop, add the server configuration:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "faker-server": {
      "command": "/path/to/faker-server/build/index.js"
    }
  }
}

Debugging

Since MCP servers communicate via standard input and output, debugging can be challenging. We recommend using the MCP Inspector, which is provided as a package script:

npm run inspector

The inspector will generate a URL to access the browser debugging tools.