text-to-reality

Servidor MCP local que ayuda a agentes de IA a planificar y validar dispositivos construibles: listas de piezas, piezas impresas en 3D, cableado, firmware, guías ilustradas y pruebas. No requiere cuenta ni clave API.

GitHub

Documentación

text-to-reality

Dale a tu agente el poder de construir cosas reales.

text-to-cad fabrica una pieza. text-to-reality fabrica el dispositivo funcional.

Describe algo que quieras que exista. Tu agente lo convierte en un paquete de construcción que cualquiera puede armar siguiendo imágenes:

una lista de piezas que puedes pedir, usando piezas que se conectan entre sí
piezas imprimibles en 3D para la carcasa y los soportes
el cableado, cada cable y en qué conector va
el código, listo para cargar
una guía visual paso a paso escrita para alguien que nunca ha construido electrónica
pruebas, para que sepas que funciona

Sin soldadura, sin protoboard, sin experiencia en electrónica requerida. Se ejecuta en tu máquina: sin cuenta, sin clave de API, y tus proyectos son carpetas simples que te pertenecen.

Ejemplo: Agent Meter

"Construyeme un pequeño personaje de escritorio que muestre lo que está haciendo mi agente de codificación y cuánto de mi asignación de Claude queda."

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

Agent Meter ilustra este flujo de trabajo: un Seeed Studio XIAO ESP32-S3 y una pequeña pantalla dentro de un personaje impreso, cableado con conectores de inserción, con firmware y una guía visual. Su cara muestra cuando tu agente está trabajando, ha terminado o esperando tu respuesta, además de tu asignación restante.

Consigue el kit Agent Meter →

Instalación

Pídele a tu agente

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

O instálalo tú mismo. text-to-reality se ejecuta mediante uv: verifica que esté instalado con uv --version, o usa el instalador de uv. Luego ejecuta los comandos para tu agente y reinícialo.

Claude Code

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

Para actualizar: claude plugin marketplace update ai-wes, luego 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

Cursor también carga el plugin de Claude Code; si ya está instalado, omite esto.

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

Claude Desktop

Añade el servidor a la configuración de Claude Desktop (Settings > Developer > Edit Config), luego reinicia. Si no encuentra uvx, usa su ruta completa (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"]
    }
  }
}

Los proyectos se guardan en text-to-reality/ en la carpeta donde se inicia la aplicación; establece TEXT_TO_REALITY_DIR en env para elegir otra carpeta.

Otros agentes

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

Luego añade el servidor MCP anterior a la configuración MCP de tu agente.

Funciona con text-to-cad

text-to-reality planifica todo el dispositivo; text-to-cad es excelente para las piezas impresas. Instala ambos, y el agente usará text-to-cad para las piezas impresas cuando esté disponible.

Cómo funciona

Cada construcción es una carpeta. El agente completa siete etapas y las verifica:

Etapa	Qué contiene
Requisitos	`brief.md`: qué hace, tamaño, energía, presupuesto, cómo sabrás que funciona
Piezas	`bom.json`: cada pieza y cantidad
Piezas impresas	fuente CAD y archivos STL/3MF
Electrónica	`wiring.json`: cada cable, su color y su conector
Código	fuente del firmware y cómo cargarlo
Ensamblaje	la guía visual
Pruebas	qué verificar y cómo se ve un resultado exitoso

El servidor MCP local le da al agente herramientas para crear proyectos, registrar archivos, detectar archivos editados después de ser verificados, validar el paquete, mantener un historial de construcción y consultar diseños de cabeceras de placas y piezas de inserción.

También puedes verificar una carpeta tú mismo:

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

Piezas que se conectan entre sí

Los cables puente sueltos se caen y se intercambian. JIG_ fabrica conectores que convierten los cables que van a una fila de pines en un solo enchufe, de modo que el cableado se convierte en conectar cosas.

El agente usa conectores JIG_ por defecto. Consulta las filas de pines de cada placa, elige un conector por fila, lista qué comprar y anota cualquier fila donde un conector no quepa. Consíguelos en jig-robotics.com →

Cada conector es una base que sostiene los cables en orden y una tapa que encaja. La guía visual muestra cómo cargarlo, cerrarlo y conectarlo.

Licencia

MIT