StructSmith
StructSmith es una herramienta local-first para modelado de arquitectura de software estilo C4, con editor React Flow, soporte MCP nativo y almacenamiento SQLite. Alternativa self-hosted a Structurizr que permite edición colaborativa con clientes de IA.
Ficha actualizada 22 sept 2026, 16:30 · upstream 21 sept 2026, 16:14 · release v1.10.3
Qué es StructSmith
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
StructSmith es una herramienta open source de modelado de arquitectura de software que prioriza el enfoque local-first, permitiendo trabajar sin dependencia de la nube ni telemetría. Utiliza un modelo semántico estilo C4 como fuente de verdad, donde React Flow solo visualiza y organiza ese modelo subyacente.
La aplicación se ejecuta en un único contenedor Docker con SQLite como base de datos persistente. Ofrece interfaz web moderna basada en React/Next.js, API REST y soporte nativo para MCP (Model Context Protocol) mediante transporte HTTP streamable. Esto permite que clientes de IA como Claude Code, Codex o GitHub Copilot editen el mismo modelo arquitectónico directamente.
El proyecto está licenciado bajo MIT, sin requerimientos de cuenta ni servicios externos. Soporta despliegue con Docker Compose o ejecución local con Bun para desarrollo. Incluye endpoints REST, MCP y UI en la misma capa de dominio, facilitando integración con asistentes de IA que pueden inspeccionar, modificar y validar modelos arquitectónicos mediante herramientas programáticas.
- Modelado colaborativo de arquitectura de software con asistencia de IA a través de MCP
- Documentación de sistemas empresariales siguiendo el modelo C4 (contexto, contenedores, componentes)
- Pre-ventas y diseño de soluciones arquitectónicas para clientes externos
- Talleres de arquitectura donde múltiples participantes editan un mismo modelo en tiempo real
- Exportación de modelos a Mermaid o otros formatos para documentación estática
- Soporte MCP nativo con transporte HTTP streamable, no requiere configuración adicional
- Modelo semántico C4 como fuente de verdad, separando visualización del modelo lógico
- Single container con SQLite persistente, sin dependencias externas obligatorias
- Licencia MIT sin telemetría, cuentas ni servicios en la nube
- API REST y MCP en el mismo endpoint, simplificando despliegue
- Sistema de revisiones atómico con model_apply_operations para cambios seguros
- Requiere Bun como runtime principal (no Node.js estándar)
- Transporte SSE no implementado, solo HTTP streamable disponible
- Dependencia de Docker para despliegue estable en producción
- No incluye autenticación por defecto, requiere configuración manual para entornos multiusuario
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para producción: usar imagen oficial ghcr.io/dziksu/structsmith:latest con volumen persistente structsmith-data:/data. Mapear puerto 8090 al host. Para desarrollo local: clonar repositorio y ejecutar bun install --frozen-lockfile, luego bun run dev. El sitio web estático se genera con bun run build:site para GitHub Pages. Verificar que Bun esté instalado antes de construir desde fuente.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.