text-to-reality

Servidor MCP local que ajuda agentes de IA a planejar e validar dispositivos construíveis: listas de peças, peças impressas em 3D, fiação, firmware, guias ilustrados e testes. Não requer conta ou chave de API.

GitHub

Documentação

text-to-reality

Dê ao seu agente o poder de construir coisas reais.

text-to-cad cria uma peça. text-to-reality cria o dispositivo funcional.

Descreva algo que você quer que exista. Seu agente transforma isso em um pacote de montagem que qualquer pessoa pode montar seguindo imagens:

uma lista de peças que você pode encomendar, usando peças que se encaixam
peças imprimíveis em 3D para a caixa e os suportes
a fiação, cada fio e em qual conector ele entra
o código, pronto para carregar
um guia ilustrado passo a passo escrito para quem nunca montou eletrônicos
testes, para você saber que funciona

Sem solda, sem protoboard, sem experiência com eletrônica. Tudo roda na sua máquina: sem conta, sem chave de API, e seus projetos são pastas simples que você controla.

Exemplo: Agent Meter

"Construa para mim um pequeno personagem de mesa que mostre o que meu agente de codificação está fazendo e quanto do meu limite do Claude ainda resta."

Agent Meter, a small printed robot character with a screen in its head (concept render)

O Agent Meter ilustra esse fluxo de trabalho: um Seeed Studio XIAO ESP32-S3 e uma pequena tela dentro de um personagem impresso, conectado com conectores de encaixe, com firmware e um guia ilustrado. O rosto dele mostra quando seu agente está trabalhando, terminou ou esperando por você, além do seu limite restante.

Compre o kit Agent Meter →

Instalação

Peça ao seu agente

Install text-to-reality from https://github.com/ai-wes/text-to-reality

Ou instale você mesmo. O text-to-reality roda através do uv: verifique se está instalado com uv --version, ou use o instalador do uv. Depois execute os comandos para o seu agente e reinicie-o.

Claude Code

claude plugin marketplace add ai-wes/text-to-reality
claude plugin install text-to-reality@ai-wes

Para atualizar: claude plugin marketplace update ai-wes, depois claude plugin update text-to-reality@ai-wes.

Codex

codex plugin marketplace add ai-wes/text-to-reality
codex plugin add text-to-reality@ai-wes

Cursor

O Cursor também carrega o plugin do Claude Code; se já estiver instalado, pule esta etapa.

git clone --depth 1 https://github.com/ai-wes/text-to-reality ~/.cursor/plugins/local/text-to-reality

Claude Desktop

Adicione o servidor à configuração do Claude Desktop (Configurações > Desenvolvedor > Editar Config), depois reinicie. Se ele não encontrar uvx, use o caminho completo (which uvx).

{
  "mcpServers": {
    "text-to-reality": {
      "command": "uvx",
      "args": ["--no-config", "--managed-python", "--python", "3.13", "--from", "text-to-reality==0.1.1", "text-to-reality", "mcp"]
    }
  }
}

Os projetos são salvos em text-to-reality/ na pasta em que o aplicativo inicia; defina TEXT_TO_REALITY_DIR em env para escolher outra pasta.

Outros agentes

npx skills add ai-wes/text-to-reality

Depois adicione o servidor MCP acima à configuração MCP do seu agente.

Funciona com text-to-cad

O text-to-reality planeja o dispositivo inteiro; o text-to-cad é excelente para as peças impressas. Instale ambos, e o agente usará o text-to-cad para as peças impressas quando estiver disponível.

Como funciona

Cada montagem é uma pasta. O agente preenche sete etapas e as verifica:

Etapa	O que contém
Requisitos	`brief.md`: o que faz, tamanho, energia, orçamento, como você saberá que funciona
Peças	`bom.json`: cada peça e quantidade
Peças impressas	Fonte CAD e arquivos STL/3MF
Eletrônica	`wiring.json`: cada fio, sua cor e seu conector
Código	fonte do firmware e como carregá-lo
Montagem	o guia ilustrado
Testes	o que verificar e como é um resultado aprovado

O servidor MCP local dá ao agente ferramentas para criar projetos, registrar arquivos, detectar arquivos editados após a verificação, validar o pacote, manter um histórico de montagens e consultar layouts de cabeçalhos de placas e peças de encaixe.

Você também pode verificar uma pasta você mesmo:

uvx text-to-reality check ./text-to-reality/my-build

Peças que se encaixam

Fios jumper soltos caem e são trocados. A JIG_ fabrica conectores que transformam os fios que vão para uma fileira de pinos em um único plugue, então a fiação vira algo de encaixar.

O agente usa conectores JIG_ por padrão. Ele consulta as fileiras de pinos de cada placa, escolhe um conector por fileira, lista o que comprar e anota qualquer fileira em que um conector não caiba. Compre em jig-robotics.com →

Cada conector é uma base que segura os fios em ordem e uma tampa que se encaixa. O guia ilustrado mostra como carregá-lo, fechá-lo e encaixá-lo.

Licença

MIT