Docs / Core

ShapeContext

La gestión del contexto del mañana, impulsada por IA local.

La primera aplicación de notas con Tool Calling autónomo y Model Context Protocol nativo. Mantén tus secretos, exporta tu conocimiento y empodera a tus orquestadores de IA favoritos.

Storage

Velocidad Extrema

Motor SQLite FTS5 para búsquedas instantáneas y almacenamiento 100% local y privado.

Agent

Agente Autónomo

No es solo un chat. El asistente IA puede leer, crear, clasificar y modificar la app por ti.

Protocol

Universal MCP

Comparte notas selectas con Claude Desktop o Cursor mediante protocolo Stdio y SSE.

Instalación y Ejecución

ShapeContext se distribuye como un paquete CLI global de NPM para Node.js. Esto permite una integración limpia sin configuraciones complejas.

Requisito Previo

Node.js (v18 o superior)

1. Instalación Global

Abre tu terminal (PowerShell, CMD, Bash) y ejecuta:

npm install -g shapecontext

2. Arrancar la aplicación

Una vez instalado, simplemente teclea el comando base desde cualquier directorio:

shapecontext

Esto levantará el servidor en el puerto 3000 y abrirá automáticamente tu navegador.

Gestión de Notas y Editor

ShapeContext utiliza una interfaz limpia con pestañas para mantener múltiples contextos abiertos simultáneamente.

  • Creación y Autoguardado: El sistema genera borradores temporales y guarda automáticamente los cambios en SQLite tras 1.5s de inactividad mientras escribes.
  • Clasificación: Asigna categorías personalizadas a tus notas para organizar el conocimiento. El panel central mostrará estadísticas de uso.
  • Importación Masiva: En Ajustes, puedes importar múltiples archivos de texto plano (.txt) de tu ordenador. El sistema los procesará e indexará instantáneamente.

Configuración Inteligente y Agente

En la pestaña de Ajustes puedes conectar el motor de IA que prefieras:

OpenAI (Por defecto)

Ingresa tu API Key para usar gpt-4o-mini de inmediato.

Modelos Locales

Cambia la Base URL apuntando a Ollama o LM Studio (ej. http://localhost:1234/v1) para procesar todo sin internet.

Asistente con Tool Calling

El chatbot lateral entiende intenciones complejas y puede modificar la aplicación por ti. Prueba pedirle:

💬

"Crea una nota secreta con la receta de mi abuela y clasifícala en Recetas."

💬

"Cámbiame el tema visual de la aplicación a modo oscuro."

Integración MCP (Model Context Protocol)

Expón el conocimiento de tus notas a otras IAs de forma controlada y universal.

Privacidad por diseño

Los clientes MCP externos SOLO podrán leer las notas donde hayas marcado activamente la casilla "Disponible para MCP" dentro del editor.

Método 1: Transporte Stdio (Claude / Cursor)

Ideal para orquestadores locales de escritorio.

Añade esto a tu archivo de configuración (ej. claude_desktop_config.json):

{
  "mcpServers": {
    "shapecontext": {
      "command": "shapecontext-mcp"
    }
  }
}

* ShapeContext debe estar corriendo en tu PC para que este comando puente pueda conectarse a tu base de datos.

Método 2: Transporte SSE

Para agentes en red o el Inspector MCP oficial, el servidor HTTP expone el streaming de eventos directamente en:

http://localhost:3000/mcp/sse