faker-mcp
A free, open-source MCP server that generates fake data using faker-go. Powered by mcp-grpc-gateway.
Hosted endpoint: https://free.cadenya.com/faker-mcp
Why?
This is more of a proof of concept for mcp-grpc-gateway than it is a valuable MCP server. However there are times when using fake data in an LLMs conversation can be useful to generate company names, addresses, etc. Can LLMs do that? Sure. But that's not the point.
It is hosted for free by Cadenya, an Agent Runtime.
Tools
The footprint of tools is very low (not every faker category is loaded into context, that would be a waste of input tokens).
| Tool | Description |
|---|---|
GetFakerOptions | Lists supported fake data generators. Use filter to narrow by name, category, or description. |
GenerateFake | Generates one fake data value by option name and optional arguments. |
GenerateCurseWord | Generates one PG-13 curse word from a small built-in list. |
The service builds its catalog from the exported faker-go API at startup. It includes every reflected method that can be called with JSON-friendly scalar arguments and returned as text or JSON. Example faker names: person.name, internet.email, company.name, address.city, lorem.sentence, faker.int_between, uuid.v4, color.hex.
Run Locally
docker compose up --buildThe MCP endpoint is available at http://localhost:8080/faker-mcp.
Development
Prerequisites
- Go 1.24+
- buf (for proto regeneration)
- Docker (for local testing)
Build
go build -o faker-mcp .Test
go test ./...Regenerate Protos
buf generateArchitecture
┌─────────────────────────────────────────────┐
│ Pod │
│ │
│ ┌──────────────┐ ┌───────────────────┐ │
│ │ faker-mcp │ │ mcp-grpc-gateway │ │
│ │ (gRPC :50051)│◄───│ (HTTP :8080) │ │
│ └──────────────┘ └───────────────────┘ │
│ │ │
└──────────────────────────────┼──────────────┘
│
Ingress (free.cadenya.com/faker-mcp)The faker gRPC service and the MCP gateway run as a sidecar pair. The gateway uses gRPC reflection to discover the service schema and exposes it as MCP tools over HTTP.
Usage
Claude Code
claude mcp add faker --transport http https://free.cadenya.com/faker-mcpCodex
codex mcp add faker --url https://free.cadenya.com/faker-mcpClaude Desktop
Add to your MCP configuration:
{
"mcpServers": {
"faker": {
"type": "streamable-http",
"url": "https://free.cadenya.com/faker-mcp"
}
}
}curl
# Initialize
curl -sS https://free.cadenya.com/faker-mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'
# List tools
curl -sS https://free.cadenya.com/faker-mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'
# Generate fake data
curl -sS https://free.cadenya.com/faker-mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"GenerateFake","arguments":{"name":"internet.email"}}}'
# Generate a PG-13 curse word
curl -sS https://free.cadenya.com/faker-mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"GenerateCurseWord","arguments":{}}}'Deployment
This project uses Kustomize manifests designed for ArgoCD:
# Preview production manifests
kubectl kustomize k8s/overlays/production
# Apply directly (prefer ArgoCD for production)
kubectl apply -k k8s/overlays/productionThe production overlay deploys to free.cadenya.com/faker-mcp with 2 replicas.
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under MIT— you can use, modify, and redistribute it under that license's terms.