Skip to main content
Glama
Faker MCP Server

Faker MCP Server

by kentrino

faker-server MCP Server

MCP server to get fake strings

This is a TypeScript-based MCP server that provides tools for generating fake data using Faker.js. It demonstrates core MCP concepts by providing:

  • Tools for generating various types of fake data (person, lorem, internet, etc.)

  • Support for different locales for internationalization

  • Customizable options for each data type

Features

Tools

  • generate_person - Generate fake person data (names, job titles, etc.)

  • generate_lorem - Generate fake lorem ipsum text

  • generate_internet - Generate fake internet data (emails, usernames, URLs, etc.)

  • generate_date - Generate fake dates

  • generate_commerce - Generate fake commerce data (products, prices, etc.)

  • And many more modules from Faker.js

Features

  • Support for multiple locales (en, ja, fr, etc.)

  • Customizable field selection for each data type

  • Configurable parameters (length, count, min/max values, etc.)

Related MCP server: mockhero

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Testing

Run all tests:

npm test

Run tests in watch mode:

npm run test:watch

Run integration tests specifically:

npm run test:integration

Generate test coverage report:

npm run test:coverage

Installation

To use with Claude Desktop, add the server config:

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 over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

Available Tools

230 tools
airline-aircraftTypeB

Returns a random aircraft type.

Inputs: no named parameters.

airline-airline-iataCodeC

Generates a random airline.

Inputs: no named parameters.

airline-airline-nameB

Generates a random airline.

Inputs: no named parameters.

airline-airplane-iataTypeCodeC

Generates a random airplane model.

Inputs: no named parameters.

airline-airplane-nameB

Generates a random airplane model.

Inputs: no named parameters.

airline-airport-iataCodeC

Generates a random airport.

Inputs: no named parameters.

airline-airport-nameB

Generates a random airport.

Inputs: no named parameters.

airline-flightNumberB

Returns a random flight number.

Inputs: length, addLeadingZeros.

airline-recordLocatorA

Generates a random record locator (booking reference number).

Inputs: allowNumerics, allowVisuallySimilarCharacters.

airline-seatC

Generates a random seat.

Inputs: aircraftType.

animal-bearB

Returns a random bear species.

Inputs: no named parameters.

animal-birdB

Returns a random bird species.

Inputs: no named parameters.

animal-catB

Returns a random cat breed.

Inputs: no named parameters.

animal-cetaceanA

Returns a random cetacean species.

Inputs: no named parameters.

animal-cowA

Returns a random cow species.

Inputs: no named parameters.

animal-crocodiliaB

Returns a random crocodilian species.

Inputs: no named parameters.

animal-dogA

Returns a random dog breed.

Inputs: no named parameters.

animal-fishB

Returns a random fish species.

Inputs: no named parameters.

animal-horseB

Returns a random horse breed.

Inputs: no named parameters.

animal-insectA

Returns a random insect species.

Inputs: no named parameters.

animal-lionB

Returns a random lion species.

Inputs: no named parameters.

animal-petNameA

Returns a random pet name.

Inputs: no named parameters.

animal-rabbitB

Returns a random rabbit species.

Inputs: no named parameters.

animal-rodentB

Returns a random rodent breed.

Inputs: no named parameters.

animal-snakeB

Returns a random snake species.

Inputs: no named parameters.

animal-typeB

Returns a random animal type.

Inputs: no named parameters.

book-authorB

Returns a random author name.

Inputs: no named parameters.

book-formatB

Returns a random book format.

Inputs: no named parameters.

book-genreB

Returns a random genre.

Inputs: no named parameters.

book-publisherB

Returns a random publisher.

Inputs: no named parameters.

book-seriesA

Returns a random series.

Inputs: no named parameters.

book-titleB

Returns a random title.

Inputs: no named parameters.

color-cmykC

Returns a CMYK color.

Inputs: format.

color-colorByCSSColorSpaceC

Returns a random color based on CSS color space specified.

Inputs: space, format.

color-cssSupportedFunctionB

Returns a random css supported color function name.

Inputs: no named parameters.

color-cssSupportedSpaceB

Returns a random css supported color space name.

Inputs: no named parameters.

color-hslC

Returns an HSL color.

Inputs: format, includeAlpha.

color-humanA

Returns a random human-readable color name.

Inputs: no named parameters.

color-hwbC

Returns an HWB color.

Inputs: format.

color-labC

Returns a LAB (CIELAB) color.

Inputs: format.

color-lchC

Returns an LCH color.

Inputs: format.

color-rgbC

Returns an RGB color.

Inputs: casing, format, prefix, includeAlpha.

color-spaceC

Returns a random color space name from the worldwide accepted color spaces.

Inputs: no named parameters.

commerce-departmentC

Returns a department inside a shop.

Inputs: no named parameters.

commerce-isbnC

Returns a random ISBN identifier.

Inputs: union (required).

commerce-priceC

Generates a price between min and max (inclusive).

Inputs: dec, max, min, symbol.

commerce-productC

Returns a short product name.

Inputs: no named parameters.

commerce-productAdjectiveC

Returns an adjective describing a product.

Inputs: no named parameters.

commerce-productDescriptionC

Returns a product description.

Inputs: no named parameters.

commerce-productMaterialC

Returns a material of a product.

Inputs: no named parameters.

commerce-productNameA

Generates a random descriptive product name.

Inputs: no named parameters.

company-buzzAdjectiveA

Returns a random buzz adjective that can be used to demonstrate data being viewed by a manager.

Inputs: no named parameters.

company-buzzNounA

Returns a random buzz noun that can be used to demonstrate data being viewed by a manager.

Inputs: no named parameters.

company-buzzPhraseA

Generates a random buzz phrase that can be used to demonstrate data being viewed by a manager.

Inputs: no named parameters.

company-buzzVerbA

Returns a random buzz verb that can be used to demonstrate data being viewed by a manager.

Inputs: no named parameters.

company-catchPhraseB

Generates a random catch phrase that can be displayed to an end user.

Inputs: no named parameters.

company-catchPhraseAdjectiveA

Returns a random catch phrase adjective that can be displayed to an end user.

Inputs: no named parameters.

company-catchPhraseDescriptorA

Returns a random catch phrase descriptor that can be displayed to an end user.

Inputs: no named parameters.

company-catchPhraseNounA

Returns a random catch phrase noun that can be displayed to an end user.

Inputs: no named parameters.

company-nameB

Generates a random company name.

Inputs: no named parameters.

database-collationB

Returns a random database collation.

Inputs: no named parameters.

database-columnA

Returns a random database column name.

Inputs: no named parameters.

database-engineB

Returns a random database engine.

Inputs: no named parameters.

database-mongodbObjectIdA

Returns a MongoDB ObjectId string.

Inputs: no named parameters.

database-typeB

Returns a random database column type.

Inputs: no named parameters.

date-anytimeB

Generates a random date that can be either in the past or in the future.

Inputs: refDate.

date-betweenB

Generates a random date between the given boundaries.

Inputs: to (required), from (required).

date-betweensB

Generates random dates between the given boundaries. The dates will be returned in an array sorted in chronological order.

Inputs: to (required), from (required), count.

date-birthdateB

Returns a random birthdate. By default, the birthdate is generated for an adult between 18 and 80 years old. But you can customize the 'age' range or the 'year' range to generate a more specific birthdate.

Inputs: union (required).

date-futureB

Generates a random date in the future.

Inputs: years, refDate.

date-monthB

Returns a random name of a month.

Inputs: context, abbreviated.

date-pastB

Generates a random date in the past.

Inputs: years, refDate.

date-recentB

Generates a random date in the recent past.

Inputs: days, refDate.

date-soonC

Generates a random date in the near future.

Inputs: days, refDate.

date-timeZoneB

Returns a random IANA time zone name.

Inputs: no named parameters.

date-weekdayB

Returns a random day of the week.

Inputs: context, abbreviated.

finance-accountNameB

Generates a random account name.

Inputs: no named parameters.

finance-accountNumberC

Generates a random account number.

Inputs: length.

finance-amountB

Generates a random amount between the given bounds (inclusive).

Inputs: dec, max, min, symbol, +1 more.

finance-bicB

Generates a random SWIFT/BIC code based on the ISO-9362 format.

Inputs: includeBranchCode.

finance-bitcoinAddressC

Generates a random Bitcoin address.

Inputs: type, network.

finance-creditCardCVVB

Generates a random credit card CVV.

Inputs: no named parameters.

finance-creditCardIssuerB

Returns a random credit card issuer.

Inputs: no named parameters.

finance-creditCardNumberB

Generates a random credit card number.

Inputs: issuer.

finance-currencyB

Returns a random currency object, containing code, name, symbol, and numericCode properties.

Inputs: no named parameters.

finance-currencyCodeB

Returns a random currency code.

Inputs: no named parameters.

finance-currencyNameB

Returns a random currency name.

Inputs: no named parameters.

finance-currencyNumericCodeB

Returns a random currency numeric code.

Inputs: no named parameters.

finance-currencySymbolB

Returns a random currency symbol.

Inputs: no named parameters.

finance-ethereumAddressA

Creates a random, non-checksum Ethereum address.

Inputs: no named parameters.

finance-ibanC

Generates a random IBAN.

Inputs: formatted, countryCode.

finance-litecoinAddressB

Generates a random Litecoin address.

Inputs: no named parameters.

finance-maskedNumberC

Generates a random masked number.

Inputs: length, parens, ellipsis, maskChar.

finance-pinC

Generates a random PIN.

Inputs: length.

finance-routingNumberB

Generates a random routing number.

Inputs: no named parameters.

finance-transactionDescriptionA

Generates a random transaction description.

Inputs: no named parameters.

finance-transactionTypeB

Returns a random transaction type.

Inputs: no named parameters.

food-adjectiveB

Generates a random dish adjective.

Inputs: no named parameters.

food-descriptionB

Generates a random dish description.

Inputs: no named parameters.

food-dishB

Generates a random dish name.

Inputs: no named parameters.

food-ethnicCategoryA

Generates a random food's ethnic category.

Inputs: no named parameters.

food-fruitB

Generates a random fruit name.

Inputs: no named parameters.

food-ingredientA

Generates a random ingredient name.

Inputs: no named parameters.

food-meatB

Generates a random meat.

Inputs: no named parameters.

food-spiceB

Generates a random spice name.

Inputs: no named parameters.

food-vegetableA

Generates a random vegetable name.

Inputs: no named parameters.

git-branchB

Generates a random branch name.

Inputs: no named parameters.

git-commitDateA

Generates a date string for a git commit using the same format as git log.

Inputs: refDate.

git-commitEntryB

Generates a random commit entry as printed by git log.

Inputs: eol, merge, refDate.

git-commitMessageB

Generates a random commit message.

Inputs: no named parameters.

git-commitShaC

Generates a random commit sha.

Inputs: length.

hacker-abbreviationB

Returns a random hacker/IT abbreviation.

Inputs: no named parameters.

hacker-adjectiveB

Returns a random hacker/IT adjective.

Inputs: no named parameters.

hacker-ingverbA

Returns a random hacker/IT verb for continuous actions (en: ing suffix; e.g. hacking).

Inputs: no named parameters.

hacker-nounB

Returns a random hacker/IT noun.

Inputs: no named parameters.

hacker-phraseB

Generates a random hacker/IT phrase.

Inputs: no named parameters.

hacker-verbA

Returns a random hacker/IT verb.

Inputs: no named parameters.

image-avatarB

Generates a random avatar image url.

Inputs: no named parameters.

image-avatarGitHubB

Generates a random avatar from GitHub.

Inputs: no named parameters.

image-avatarLegacyA

Generates a random avatar from https://cloudflare-ipfs.com/ipfs/Qmd3W5DuhgHirLHGVixi6V76LhCkZUz6pnFt5AJBiyvHye/avatar. (Deprecated: The links are no longer working. Use avatar() instead.)

Inputs: no named parameters.

image-dataUriB

Generates a random data uri containing an URL-encoded SVG image or a Base64-encoded SVG image.

Inputs: type, color, width, height.

image-personPortraitB

Generates a random square portrait (avatar) of a person. These are static images of fictional people created by an AI, Stable Diffusion 3.

Inputs: sex, size.

image-urlC

Generates a random image url.

Inputs: width, height.

image-urlLoremFlickrC

Generates a random image url provided via https://loremflickr.com.

Inputs: width, height, category.

image-urlPicsumPhotosC

Generates a random image url provided via https://picsum.photos.

Inputs: blur, width, height, grayscale.

image-urlPlaceholderA

Generates a random image url provided via https://via.placeholder.com/. (Deprecated: The service has bad uptime. Use faker.image.url() or faker.image.dataUri() instead.)

Inputs: text, width, format, height, +2 more.

internet-colorA

Generates a random css hex color code in aesthetically pleasing color palette. (Deprecated: Please use faker.color.rgb() or any of the other color methods instead.)

Inputs: redBase, blueBase, greenBase.

internet-displayNameB

Generates a display name using the given person's name as base.

Inputs: lastName, firstName.

internet-domainNameB

Generates a random domain name.

Inputs: no named parameters.

internet-domainSuffixB

Returns a random domain suffix.

Inputs: no named parameters.

internet-domainWordC

Generates a random domain word.

Inputs: no named parameters.

internet-emailC

Generates an email address using the given person's name as base.

Inputs: lastName, provider, firstName, allowSpecialCharacters.

internet-emojiC

Generates a random emoji.

Inputs: types.

internet-exampleEmailB

Generates an email address using an example mail provider using the given person's name as base.

Inputs: lastName, firstName, allowSpecialCharacters.

internet-httpMethodB

Returns a random http method.

Inputs: no named parameters.

internet-httpStatusCodeB

Generates a random HTTP status code.

Inputs: types.

internet-ipB

Generates a random IPv4 or IPv6 address.

Inputs: no named parameters.

internet-ipv4C

Generates a random IPv4 address.

Inputs: network, cidrBlock.

internet-ipv6B

Generates a random IPv6 address.

Inputs: no named parameters.

internet-jwtC

Generates a random JWT (JSON Web Token).

Inputs: header, payload, refDate.

internet-jwtAlgorithmB

Generates a random JWT (JSON Web Token) Algorithm.

Inputs: no named parameters.

internet-macC

Generates a random mac address.

Inputs: separator.

internet-passwordC

Generates a random password-like string.

Inputs: length, prefix, pattern, memorable.

internet-portB

Generates a random port number.

Inputs: no named parameters.

internet-protocolA

Returns a random web protocol. Either http or https.

Inputs: no named parameters.

internet-urlB

Generates a random http(s) url.

Inputs: protocol, appendSlash.

internet-userAgentB

Generates a random user agent string.

Inputs: no named parameters.

internet-usernameB

Generates a username using the given person's name as base.

Inputs: lastName, firstName.

internet-userNameB

Generates a username using the given person's name as base. (Deprecated: Use faker.internet.username() instead.)

Inputs: lastName, firstName.

location-buildingNumberB

Generates a random building number.

Inputs: no named parameters.

location-cardinalDirectionB

Returns a random cardinal direction (north, east, south, west).

Inputs: abbreviated.

location-cityB

Generates a random localized city name.

Inputs: no named parameters.

location-continentA

Returns a random continent name.

Inputs: no named parameters.

location-countryA

Returns a random country name.

Inputs: no named parameters.

location-countryCodeB

Returns a random ISO_3166-1 country code.

Inputs: variant.

location-countyA

Returns a random localized county, or other equivalent second-level administrative entity for the locale's country such as a district or department.

Inputs: no named parameters.

location-directionA

Returns a random direction (cardinal and ordinal; northwest, east, etc).

Inputs: abbreviated.

location-languageB

Returns a random spoken language.

Inputs: no named parameters.

location-latitudeC

Generates a random latitude.

Inputs: max, min, precision.

location-longitudeC

Generates a random longitude.

Inputs: max, min, precision.

location-nearbyGPSCoordinateB

Generates a random GPS coordinate within the specified radius from the given coordinate.

Inputs: origin, radius, isMetric.

location-ordinalDirectionB

Returns a random ordinal direction (northwest, southeast, etc).

Inputs: abbreviated.

location-secondaryAddressA

Generates a random localized secondary address. This refers to a specific location at a given address such as an apartment or room number.

Inputs: no named parameters.

location-stateB

Returns a random state, or other equivalent first-level administrative entity for the locale's country such as a province, region, or prefecture.

Inputs: abbreviated.

location-streetB

Returns a random street name.

Inputs: no named parameters.

location-streetAddressB

Generates a random localized street address.

Inputs: useFullAddress.

location-timeZoneB

Returns a random time zone.

Inputs: no named parameters.

location-zipCodeC

Generates a random localized zip code.

Inputs: state, format.

lorem-linesB

Generates the given number lines of lorem separated by '\n'.

Inputs: lineCount.

lorem-paragraphB

Generates a paragraph with the given number of sentences.

Inputs: sentenceCount.

lorem-paragraphsC

Generates the given number of paragraphs.

Inputs: separator, paragraphCount.

lorem-sentenceC

Generates a space separated list of words beginning with a capital letter and ending with a period.

Inputs: wordCount.

lorem-sentencesC

Generates the given number of sentences.

Inputs: separator, sentenceCount.

lorem-slugB

Generates a slugified text consisting of the given number of hyphen separated words.

Inputs: wordCount.

lorem-textC

Generates a random text based on a random lorem method.

Inputs: no named parameters.

lorem-wordC

Generates a word of a specified length.

Inputs: length, strategy.

lorem-wordsB

Generates a space separated list of words.

Inputs: count.

music-albumA

Returns a random album name.

Inputs: no named parameters.

music-artistA

Returns a random artist name.

Inputs: no named parameters.

music-genreB

Returns a random music genre.

Inputs: no named parameters.

music-songNameB

Returns a random song name.

Inputs: no named parameters.

person-bioA

Returns a random short biography.

Inputs: no named parameters.

person-firstNameB

Returns a random first name.

Inputs: sex.

person-fullNameB

Generates a random full name.

Inputs: sex, lastName, firstName.

person-genderB

Returns a random gender.

Inputs: no named parameters.

person-jobAreaB

Generates a random job area.

Inputs: no named parameters.

person-jobDescriptorC

Generates a random job descriptor.

Inputs: no named parameters.

person-jobTitleB

Generates a random job title.

Inputs: no named parameters.

person-jobTypeB

Generates a random job type.

Inputs: no named parameters.

person-lastNameB

Returns a random last name.

Inputs: sex.

person-middleNameC

Returns a random middle name.

Inputs: sex.

person-prefixB

Returns a random person prefix.

Inputs: sex.

person-sexB

Returns a random sex.

Inputs: no named parameters.

person-sexTypeA

Returns a random sex type. The SexType is intended to be used in parameters and conditions.

Inputs: no named parameters.

person-suffixB

Returns a random person suffix.

Inputs: no named parameters.

person-zodiacSignB

Returns a random zodiac sign.

Inputs: no named parameters.

phone-imeiB

Generates IMEI number.

Inputs: no named parameters.

phone-numberB

Generates a random phone number.

Inputs: style.

science-chemicalElementB

Returns a random periodic table element.

Inputs: no named parameters.

science-unitC

Returns a random scientific unit.

Inputs: no named parameters.

system-commonFileExtB

Returns a commonly used file extension.

Inputs: no named parameters.

system-commonFileNameB

Returns a random file name with a given extension or a commonly used extension.

Inputs: extension.

system-commonFileTypeC

Returns a commonly used file type.

Inputs: no named parameters.

system-cronB

Returns a random cron expression.

Inputs: includeYear, includeNonStandard.

system-directoryPathC

Returns a directory path.

Inputs: no named parameters.

system-fileExtC

Returns a file extension.

Inputs: mimeType.

system-fileNameB

Returns a random file name with extension.

Inputs: extensionCount.

system-filePathC

Returns a file path.

Inputs: no named parameters.

system-fileTypeC

Returns a file type.

Inputs: no named parameters.

system-mimeTypeC

Returns a mime-type.

Inputs: no named parameters.

system-networkInterfaceC

Returns a random network interface.

Inputs: interfaceType, interfaceSchema.

system-semverC

Returns a semantic version.

Inputs: no named parameters.

vehicle-bicycleC

Returns a type of bicycle.

Inputs: no named parameters.

vehicle-colorC

Returns a vehicle color.

Inputs: no named parameters.

vehicle-fuelC

Returns a fuel type.

Inputs: no named parameters.

vehicle-manufacturerB

Returns a manufacturer name.

Inputs: no named parameters.

vehicle-modelC

Returns a vehicle model.

Inputs: no named parameters.

vehicle-typeC

Returns a vehicle type.

Inputs: no named parameters.

vehicle-vehicleC

Returns a random vehicle.

Inputs: no named parameters.

vehicle-vinC

Returns a vehicle identification number (VIN).

Inputs: no named parameters.

vehicle-vrmB

Returns a vehicle registration number (Vehicle Registration Mark - VRM).

Inputs: no named parameters.

word-adjectiveC

Returns a random adjective.

Inputs: options.

word-adverbC

Returns a random adverb.

Inputs: options.

word-conjunctionC

Returns a random conjunction.

Inputs: options.

word-interjectionC

Returns a random interjection.

Inputs: options.

word-nounC

Returns a random noun.

Inputs: options.

word-prepositionC

Returns a random preposition.

Inputs: options.

word-sampleB

Returns a random word, that can be an adjective, adverb, conjunction, interjection, noun, preposition, or verb.

Inputs: options.

word-verbB

Returns a random verb.

Inputs: options.

word-wordsB

Returns a random string containing some words separated by spaces.

Inputs: options.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 230 tools

    Disambiguation3/5

    The category-prefixed names make most generators distinguishable, but there is substantial overlap among granular variants: person-gender/sex/sexType, internet-userName/username, date-timeZone/location-timeZone, and many component generators (company-catchPhraseAdjective/Noun, etc.). Deprecated duplicates and near-synonyms add ambiguity, though descriptions usually clarify the intended output.

    Naming Consistency4/5

    Names consistently follow a category-resource pattern such as book-title, finance-iban, and vehicle-vin, with lower-case hyphenated prefixes and camelCase entity names. Minor inconsistencies appear in duplicate casing like internet-userName vs internet-username and in nested names like airline-airport-iataCode.

    Tool Count1/5

    230 tools is far beyond an appropriate MCP surface, even for a comprehensive Faker wrapper. Mapping nearly every Faker method to its own tool creates severe selection overhead and should instead be consolidated through category or method parameters.

    Completeness3/5

    Coverage spans many Faker domains including person, location, finance, internet, color, and lorem, but core generators such as random numbers, strings/UUIDs, booleans, and arrays are absent. The surface is broad but has notable gaps for common faker use cases.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Generates realistic mock data using Faker.js for database seeding, API testing, and development environments. Supports person/company data, custom patterns, multi-locale generation, and structured datasets with referential integrity.
      4
      62 npm
      7
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides tools for generating fake data using Faker.js, including person, lorem, internet, and more, with support for multiple locales and customizable options.
      MIT