faker-mcp

Um servidor MCP hospedado para gerar dados fictícios usando faker-go

Documentação

faker-mcp

Um servidor MCP gratuito e de código aberto que gera dados falsos usando faker-go. Desenvolvido com mcp-grpc-gateway.

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

Por quê?

Isto é mais uma prova de conceito para o mcp-grpc-gateway do que um servidor MCP valioso. No entanto, há momentos em que usar dados falsos em uma conversa com LLMs pode ser útil para gerar nomes de empresas, endereços, etc. LLMs conseguem fazer isso? Claro. Mas não é esse o ponto.

É hospedado gratuitamente pela Cadenya, um Agent Runtime.

Ferramentas

A pegada de ferramentas é muito baixa (nem toda categoria do faker é carregada no contexto, isso seria um desperdício de tokens de entrada).

Ferramenta	Descrição
`GetFakerOptions`	Lista os geradores de dados falsos suportados. Use `filter` para filtrar por nome, categoria ou descrição.
`GenerateFake`	Gera um valor de dados falsos pelo nome da opção e argumentos opcionais.
`GenerateCurseWord`	Gera uma palavra de baixo calão PG-13 de uma pequena lista integrada.

O serviço constrói seu catálogo a partir da API exportada do faker-go na inicialização. Inclui todos os métodos refletidos que podem ser chamados com argumentos escalares compatíveis com JSON e retornados como texto ou JSON. Exemplos de nomes do 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

Adicione à sua configuração do 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":{}}}'

Executar Localmente

docker compose up --build

O endpoint do MCP está disponível em http://localhost:8080/faker-mcp.

Desenvolvimento

Pré-requisitos

Go 1.24+
buf (para regeneração de proto)
Docker (para testes locais)

Build

go build -o faker-mcp .

Test

go test ./...

Regenerar Protos

buf generate

Implantação

Este projeto usa manifestos Kustomize projetados para ArgoCD:

# Preview production manifests
kubectl kustomize k8s/overlays/production

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

O overlay de produção é implantado em free.cadenya.com/faker-mcp com 2 réplicas.

Arquitetura

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

O serviço gRPC do faker e o gateway MCP rodam como um par sidecar. O gateway usa reflexão gRPC para descobrir o esquema do serviço e o expõe como ferramentas MCP via HTTP.

Licença

MIT