velixar-mcp-server
Memoria de IA Persistente
Documentación
Velixar MCP Server
El primer servidor de memoria cognitiva para asistentes de IA. No es un envoltorio de base de datos vectorial, sino una capa de razonamiento completa que le da a tu IA memoria persistente, un grafo de conocimiento, conciencia de identidad, detección de contradicciones y seguimiento de creencias en cada sesión.
Funciona con cualquier cliente de Model Context Protocol: Claude Desktop, Kiro, Cursor, Windsurf, Continue.dev o hosts personalizados.
Por qué existe
Cada asistente de IA empieza desde cero en cada conversación. Velixar lo soluciona, pero no solo almacenando y recuperando texto. El servidor MCP le da a tu asistente la capacidad de:
- Orientarse en un espacio de trabajo con una sola llamada, sin ensamblaje manual de contexto
- Rastrear cómo evolucionan las creencias con el tiempo y detectar cuándo se contradicen
- Construir y recorrer un grafo de conocimiento de entidades y relaciones que descubre
- Mantener un modelo de identidad persistente de quién eres, qué prefieres y cómo trabajas
- Destilar sesiones en memorias duraderas automáticamente, con deduplicación
- Importar y exportar todo tu corpus de memoria para copias de seguridad o migración
40 herramientas. 5 recursos en vivo. 19 indicaciones de flujo de trabajo. Un npm install.
Inicio rápido
npm install -g velixar-mcp-server
Obtén una clave de API en velixarai.com/settings/api-keys y luego añádela a tu cliente MCP:
{
"mcpServers": {
"velixar": {
"command": "velixar-mcp-server",
"env": {
"VELIXAR_API_KEY": "vlx_your_key_here"
}
}
}
}
Reinicia tu asistente. Listo.
Herramientas
Memoria
| Herramienta | Qué hace |
|---|---|
velixar_store | Almacena una memoria con etiquetas, nivel y tipo |
velixar_search | Búsqueda semántica en todas las memorias |
velixar_list | Explora con paginación y filtrado |
velixar_update | Edita contenido o etiquetas de una memoria existente |
velixar_delete | Elimina una memoria |
Cognitivas
| Herramienta | Qué hace |
|---|---|
velixar_context | Resumen sintetizado del espacio de trabajo: orientación en una sola llamada |
velixar_identity | Obtén, almacena o actualiza el perfil, las preferencias y la experiencia del usuario |
velixar_contradictions | Detecta hechos o creencias en conflicto con orientación para resolverlos |
velixar_timeline | Cómo ha evolucionado un tema o creencia con el tiempo |
velixar_patterns | Patrones recurrentes de problema/solución en tu historial |
velixar_inspect | Inspección profunda de una memoria específica con cadena de procedencia completa |
velixar_graph_traverse | Recorre relaciones entre entidades: «¿qué conecta con X?» |
velixar_distill | Extrae memorias duraderas del contenido de la sesión con deduplicación |
Ciclo de vida
| Herramienta | Qué hace |
|---|---|
velixar_session_save | Guarda un resumen de sesión para recuperarlo después |
velixar_session_recall | Restaura el contexto de una sesión anterior |
velixar_batch_store | Almacena hasta 20 memorias en una sola llamada |
velixar_batch_search | Ejecuta hasta 10 consultas de búsqueda simultáneamente |
velixar_consolidate | Fusiona memorias relacionadas en una única memoria duradera |
velixar_retag | Actualiza etiquetas en masa en todas las memorias |
velixar_export | Exporta memorias como JSON o Markdown, opcionalmente con datos de grafo |
velixar_import | Importación masiva desde exportaciones de JSON, Markdown, Notion u Obsidian |
Sistema
| Herramienta | Qué hace |
|---|---|
velixar_health | Conectividad del backend, latencia, estado del espacio de trabajo |
velixar_debug | Estado de caché, interruptor de circuito, tiempos de API |
velixar_capabilities | Lista de funciones, inventario de herramientas, URIs de recursos |
velixar_security | Obtén o establece el modo de escaneo de contenido |
Recursos en vivo
Los recursos se inyectan automáticamente en el contexto de tu asistente, sin necesidad de llamar a ninguna herramienta.
| Recurso | Qué proporciona |
|---|---|
velixar://system/constitution | Reglas de comportamiento y modos cognitivos para el asistente |
velixar://identity/current | Tu perfil de usuario persistente |
velixar://memories/recent | Memorias más recientes (compactas) |
velixar://memories/relevant | Memorias contextualmente relevantes según la actividad actual |
velixar://domains/{domain}/shadow_graph | Vista de grafo de conocimiento para un dominio específico |
Indicaciones de flujo de trabajo
16 indicaciones integradas que guían flujos de trabajo de razonamiento en varios pasos:
- Orientación — recupera razonamientos previos, construye contexto de proyecto, perfila una entidad, orienta y luego acota
- Conflicto — resuelve contradicciones, identifica lagunas de conocimiento
- Continuidad — rastrea la evolución de creencias, reanuda sesiones, reconstruye rutas de decisión
- Ciclo de vida — destila sesiones, consolida memoria de temas, reetiqueta memorias recientes
- Identidad — resume la identidad del usuario, detecta cambios de preferencias, alinea el estilo de respuesta
- Empresa — evalúa la idoneidad empresarial para un dominio
Aislamiento de espacios de trabajo
Las memorias están limitadas a espacios de trabajo. Tu proyecto personal nunca se mezcla con el trabajo.
| Prioridad | Fuente | Cómo |
|---|---|---|
| 1 | variable de entorno VELIXAR_WORKSPACE_ID | Explícito |
| 2 | .velixar.json en la raíz del proyecto | { "workspace_id": "my-project" } |
| 3 | Nombre del directorio raíz de Git | Automático |
Compatibilidad de hosts
| Host | Herramientas | Recursos | Indicaciones |
|---|---|---|---|
| Kiro CLI | ✅ | ✅ | ✅ |
| Claude Desktop | ✅ | ✅ | ✅ |
| Cursor | ✅ | ⚠️ | — |
| Windsurf | ✅ | ⚠️ | — |
| Continue.dev | ✅ | ✅ | ✅ |
Cuando un host no admite recursos o indicaciones, el servidor se degrada con elegancia: todas las herramientas siguen funcionando de forma independiente.
Variables de entorno
| Variable | Obligatoria | Descripción |
|---|---|---|
VELIXAR_API_KEY | Sí | Tu clave de API (empieza por vlx_) |
VELIXAR_WORKSPACE_ID | No | Ámbito de espacio de trabajo explícito |
VELIXAR_API_URL | No | Endpoint de API personalizado |
VELIXAR_USER_ID | No | Identidad de usuario final explícita. Déjala sin establecer (recomendado): la API deriva el ámbito de tu clave: ves tus propias memorias, igual que en el panel. Establécelo solo cuando una clave sirve a varios usuarios finales con nombre |
VELIXAR_DEBUG | No | true para registro detallado |
VELIXAR_LOG_FORMAT | No | json para registro estructurado de Datadog/CloudWatch |
VELIXAR_HEALTH_PORT | No | Puerto para el endpoint de verificación de salud HTTP |
Fiabilidad
- Reintento automático con retroceso exponencial (3 intentos)
- Interruptor de circuito: se abre tras fallos sostenidos y se recupera automáticamente
- Respaldo de caché: sirve datos obsoletos durante interrupciones en lugar de fallar
- Registro estructurado compatible con Datadog y CloudWatch
SDKs
Usa Velixar directamente desde código:
- JavaScript/TypeScript:
npm install velixar— documentación - Python:
pip install velixar— documentación
Integración CI/CD
- GitHub Actions: velixar-memory-sync — destila fusiones de PR en memorias
- GitHub Actions: velixar-decision-capture — almacena resoluciones de issues como decisiones
- Webhook:
POST /webhook/ci— ingesta genérica de eventos de CI
Licencia
MIT