faker-mcp

Un servidor MCP alojado para generar datos falsos usando faker-go

Documentación

faker-mcp

Un servidor MCP gratuito y de código abierto que genera datos falsos usando faker-go. Impulsado por mcp-grpc-gateway.

Endpoint alojado: https://free.cadenya.com/faker-mcp

¿Por qué?

Esto es más una prueba de concepto para mcp-grpc-gateway que un servidor MCP valioso. Sin embargo, hay ocasiones en las que usar datos falsos en una conversación con un LLM puede ser útil para generar nombres de empresas, direcciones, etc. ¿Pueden los LLM hacer eso? Claro. Pero ese no es el punto.

Está alojado de forma gratuita por Cadenya, un Agent Runtime.

Herramientas

La huella de herramientas es muy baja (no todas las categorías de faker se cargan en el contexto, eso sería un desperdicio de tokens de entrada).

Herramienta	Descripción
`GetFakerOptions`	Lista los generadores de datos falsos compatibles. Usa `filter` para filtrar por nombre, categoría o descripción.
`GenerateFake`	Genera un valor de dato falso por nombre de opción y argumentos opcionales.
`GenerateCurseWord`	Genera una palabra malsonante PG-13 de una pequeña lista integrada.

El servicio construye su catálogo a partir de la API exportada de faker-go al inicio. Incluye cada método reflejado que se puede llamar con argumentos escalares compatibles con JSON y devolver como texto o JSON. Ejemplos de nombres de faker: person.name, internet.email, company.name, address.city, lorem.sentence, faker.int_between, uuid.v4, color.hex.

Uso

Claude Code

claude mcp add faker --transport http https://free.cadenya.com/faker-mcp

Codex

codex mcp add faker --url https://free.cadenya.com/faker-mcp

Claude Desktop

Agrega a tu configuración de MCP:

{
  "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":{}}}'

Ejecutar Localmente

docker compose up --build

El endpoint de MCP está disponible en http://localhost:8080/faker-mcp.

Desarrollo

Requisitos previos

Go 1.24+
buf (para regeneración de proto)
Docker (para pruebas locales)

Compilar

go build -o faker-mcp .

Probar

go test ./...

Regenerar Protos

buf generate

Despliegue

Este proyecto usa manifiestos de Kustomize diseñados para ArgoCD:

# Preview production manifests
kubectl kustomize k8s/overlays/production

# Apply directly (prefer ArgoCD for production)
kubectl apply -k k8s/overlays/production

El overlay de producción se despliega en free.cadenya.com/faker-mcp con 2 réplicas.

Arquitectura

┌─────────────────────────────────────────────┐
│ Pod                                         │
│                                             │
│  ┌──────────────┐    ┌───────────────────┐  │
│  │ faker-mcp    │    │ mcp-grpc-gateway  │  │
│  │ (gRPC :50051)│◄───│ (HTTP :8080)      │  │
│  └──────────────┘    └───────────────────┘  │
│                              │              │
└──────────────────────────────┼──────────────┘
                               │
                         Ingress (free.cadenya.com/faker-mcp)

El servicio gRPC de faker y la puerta de enlace MCP se ejecutan como un par sidecar. La puerta de enlace usa reflexión gRPC para descubrir el esquema del servicio y lo expone como herramientas MCP sobre HTTP.

Licencia

MIT