Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

plainbase

Plainbase es un workspace de documentación autocontenido y nativo en árbol de archivos. Funciona como servidor MCP (Model Context Protocol) que permite a agentes buscar, leer y proponer cambios en documentos Markdown, con revisión humana antes del commit.

Ficha actualizada 22 sept 2026, 18:44 · upstream 22 sept 2026, 18:30 · release v0.3.2

Ver códigoProblemas y ayudaRepositorio ↗
00

Qué es plainbase

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

Plainbase es una plataforma de documentación autocontenido y nativa en árbol de archivos. Funciona como un servidor MCP (Model Context Protocol) que permite a los agentes conectarse directamente para realizar búsquedas, lectura y propuesta de cambios en documentos Markdown. Los humanos revisan las propuestas en una cola integrada antes del commit. El contenido nunca deja de ser un árbol plano de archivos. La arquitectura se documenta en el mapa de arquitectura de backend. Se puede desplegar localmente con un solo binario o mediante Docker Compose, con soporte para almacenamiento en S3 compatible.

CASOS DE USO
  • Gestionar documentación técnica de equipos
  • Crear y mantener repositorios de documentación autocontenido
  • Integración con agentes de IA para búsqueda y propuesta de contenido
  • Documentación de software con revisión humana antes del commit
  • Despliegue local sin dependencias externas ni bases de datos
  • Gestión de versiones de documentos mediante propuestas
PUNTOS DESTACADOS
  • Arquitectura nativa en árbol de archivos, no basada en base de datos externa
  • Servidor MCP único que sirve la UI web y permite conexión con agentes
  • Modos de operación: local (contenido como autoridad) y object mode (bucket S3 como autoridad)
  • Un solo binario nativo con búsqueda FTS5 en SQLite, sin dependencias adicionales
  • Soporte para agentes conectados vía MCP con tokens revocables y revisión humana
  • Docker Compose para despliegue rápido, con soporte para WSL2 en Windows
PRECAUCIONES
  • Requiere Java 21+ o una JVM distribuida compatible (no JRE nativo)
  • En modo local, el contenido debe estar en un árbol de archivos estructurado
  • El almacenamiento en S3 es derivado y no puede ser borrado sin perder datos
  • La búsqueda se basa en un índice SQLite que debe actualizarse manualmente
  • No tiene autenticación centralizada ni gestión de permisos por defecto
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU4 vCPUrecomendación inicial
MEMORIA4 GBRAM estimada
DISCO20 GBalmacenamiento base
COMPLEJIDADhighnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Docker Compose detectado

Para producción, despliega con Docker Compose usando los contenedores oficiales. Configura `PLAINBASE_CONTENT_DIR` apuntando a tu árbol Markdown y `PLAINBASE_DATA_DIR` para el estado del sistema. En modo local, usa un solo binario ejecutable; en modo object storage, configura un bucket S3 compatible como autoridad única. Actualiza periódicamente el índice de búsqueda. Para Windows, ejecuta el binario Linux vía WSL2 manteniendo los directorios en la distribución Linux.

✓Dockerfile
✓Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Node.js
SERVICIOS
MeilisearchS3/MinIO
BASES DE DATOS
Meilisearch
PUERTOS
8080
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

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.