velixar-mcp-server
Memória de IA Persistente
Documentação
Servidor MCP Velixar
O primeiro servidor de memória cognitiva para assistentes de IA. Não é um wrapper de banco de dados vetorial — é uma camada completa de raciocínio que dá à sua IA memória persistente, um grafo de conhecimento, consciência de identidade, detecção de contradições e rastreamento de crenças em todas as sessões.
Funciona com qualquer cliente Model Context Protocol: Claude Desktop, Kiro, Cursor, Windsurf, Continue.dev ou hosts personalizados.
Por Que Isso Existe
Todo assistente de IA começa do zero a cada conversa. O Velixar resolve isso — mas não apenas armazenando e recuperando texto. O servidor MCP dá ao seu assistente a capacidade de:
- Orientar-se em um workspace com uma única chamada — sem montagem manual de contexto
- Rastrear como as crenças evoluem ao longo do tempo e identificar quando se contradizem
- Construir e percorrer um grafo de conhecimento de entidades e relacionamentos que descobre
- Manter um modelo de identidade persistente de quem você é, o que prefere e como trabalha
- Destilar sessões em memórias duráveis automaticamente, com deduplicação
- Importar e exportar todo o seu corpus de memória para backup ou migração
40 ferramentas. 5 recursos ativos. 19 prompts de fluxo de trabalho. Um npm install.
Início Rápido
npm install -g velixar-mcp-server
Obtenha uma chave de API em velixarai.com/settings/api-keys e adicione ao seu cliente MCP:
{
"mcpServers": {
"velixar": {
"command": "velixar-mcp-server",
"env": {
"VELIXAR_API_KEY": "vlx_your_key_here"
}
}
}
}
Reinicie seu assistente. Pronto.
Superfície de Ferramentas
Memória
| Ferramenta | O que faz |
|---|---|
velixar_store | Armazena uma memória com tags, nível e tipo |
velixar_search | Busca semântica em todas as memórias |
velixar_list | Navega com paginação e filtros |
velixar_update | Edita conteúdo ou tags de uma memória existente |
velixar_delete | Remove uma memória |
Cognitivo
| Ferramenta | O que faz |
|---|---|
velixar_context | Briefing de workspace sintetizado — orientação em uma chamada |
velixar_identity | Obtém, armazena ou atualiza o perfil, preferências e especialização do usuário |
velixar_contradictions | Apresenta fatos ou crenças conflitantes com orientação para resolução |
velixar_timeline | Como um tópico ou crença evoluiu ao longo do tempo |
velixar_patterns | Motivos recorrentes de problema/solução no seu histórico |
velixar_inspect | Inspeção profunda de uma memória específica com cadeia completa de proveniência |
velixar_graph_traverse | Percorre relacionamentos de entidades — "o que se conecta a X?" |
velixar_distill | Extrai memórias duráveis do conteúdo da sessão com deduplicação |
Ciclo de Vida
| Ferramenta | O que faz |
|---|---|
velixar_session_save | Salva um resumo de sessão para recuperação posterior |
velixar_session_recall | Restaura contexto de uma sessão anterior |
velixar_batch_store | Armazena até 20 memórias em uma chamada |
velixar_batch_search | Executa até 10 consultas de busca simultaneamente |
velixar_consolidate | Mescla memórias relacionadas em uma única memória durável |
velixar_retag | Atualização em massa de tags em memórias |
velixar_export | Exporta memórias como JSON ou Markdown, opcionalmente com dados de grafo |
velixar_import | Importação em massa de exportações JSON, Markdown, Notion ou Obsidian |
Sistema
| Ferramenta | O que faz |
|---|---|
velixar_health | Conectividade do backend, latência, status do workspace |
velixar_debug | Estado do cache, disjuntor, tempos de API |
velixar_capabilities | Lista de recursos, inventário de ferramentas, URIs de recursos |
velixar_security | Obtém ou define o modo de varredura de conteúdo |
Recursos Ativos
Os recursos são injetados automaticamente no contexto do seu assistente — nenhuma chamada de ferramenta é necessária.
| Recurso | O que fornece |
|---|---|
velixar://system/constitution | Regras comportamentais e modos cognitivos para o assistente |
velixar://identity/current | Seu perfil de usuário persistente |
velixar://memories/recent | Memórias mais recentes (compactas) |
velixar://memories/relevant | Memórias contextualmente relevantes com base na atividade atual |
velixar://domains/{domain}/shadow_graph | Visão do grafo de conhecimento para um domínio específico |
Prompts de Fluxo de Trabalho
16 prompts integrados que guiam fluxos de raciocínio em várias etapas:
- Orientação — recupera raciocínio anterior, constrói contexto de projeto, perfil de entidade, orientar-e-depois-estreitar
- Conflito — resolve contradições, identifica lacunas de conhecimento
- Continuidade — rastreia evolução de crenças, retoma sessões, reconstrói caminhos de decisão
- Ciclo de Vida — destila sessões, consolida memória de tópicos, reetiqueta memórias recentes
- Identidade — resume identidade do usuário, detecta mudanças de preferência, alinha estilo de resposta
- Empresarial — avalia adequação empresarial para um domínio
Isolamento de Workspace
As memórias são limitadas a workspaces. Seu projeto pessoal nunca se mistura com o trabalho.
| Prioridade | Origem | Como |
|---|---|---|
| 1 | Variável de ambiente VELIXAR_WORKSPACE_ID | Explícita |
| 2 | .velixar.json na raiz do projeto | { "workspace_id": "my-project" } |
| 3 | Nome do diretório raiz do Git | Automática |
Compatibilidade de Hosts
| Host | Ferramentas | Recursos | Prompts |
|---|---|---|---|
| Kiro CLI | ✅ | ✅ | ✅ |
| Claude Desktop | ✅ | ✅ | ✅ |
| Cursor | ✅ | ⚠️ | — |
| Windsurf | ✅ | ⚠️ | — |
| Continue.dev | ✅ | ✅ | ✅ |
Quando um host não suporta recursos ou prompts, o servidor degrada graciosamente — todas as ferramentas continuam funcionando de forma independente.
Variáveis de Ambiente
| Variável | Obrigatória | Descrição |
|---|---|---|
VELIXAR_API_KEY | Sim | Sua chave de API (começa com vlx_) |
VELIXAR_WORKSPACE_ID | Não | Escopo explícito do workspace |
VELIXAR_API_URL | Não | Endpoint de API personalizado |
VELIXAR_USER_ID | Não | Identidade explícita do usuário final. Deixe não definido (recomendado): a API deriva o escopo da sua chave — você vê suas próprias memórias, igual ao painel. Defina apenas quando uma chave atende vários usuários finais nomeados |
VELIXAR_DEBUG | Não | true para registro detalhado |
VELIXAR_LOG_FORMAT | Não | json para registro estruturado Datadog/CloudWatch |
VELIXAR_HEALTH_PORT | Não | Porta para endpoint de verificação de saúde HTTP |
Confiabilidade
- Repetição automática com backoff exponencial (3 tentativas)
- Disjuntor — abre após falhas sustentadas, recupera automaticamente
- Fallback de cache — fornece dados desatualizados durante interrupções em vez de falhar
- Registro estruturado compatível com Datadog e CloudWatch
SDKs
Use o Velixar diretamente do código:
Integração CI/CD
- GitHub Actions: velixar-memory-sync — destila merges de PR em memórias
- GitHub Actions: velixar-decision-capture — armazena resoluções de issues como decisões
- Webhook:
POST /webhook/ci— ingestão genérica de eventos de CI
Licença
MIT