kaxcav-vortex
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Kaxcav Vortex (kvx v3.1.0-apex)
Motor poliglota de inteligência de código, empacotamento submodular de contexto (L0–L3), matriz de grafo esparsa CSR em memória e federação multi-repositório. Projetado para operações pesadas de engenharia de software com múltiplos agentes de IA simultâneos.
1. O Problema que o Kaxcav Vortex Resolve
Indexadores tradicionais e motores de RAG monolíticos colapsam sob carga pesada de múltiplos agentes de IA porque:
Usam um banco SQLite monolítico global cujo WAL cresce para dezenas de gigabytes (
23+ GB) quando vários repositórios sofrem mutações simultâneas;Tentam parsear PDFs, binários ou dumps SQL na heap principal (causando
VirtualAllocOOM de14+ GB);Dependem de
.gitpara ignorar diretórios vendorizados, engolindo170.000+arquivos em workspaces desacoplados;Usam PageRank estático que vicia em arquivos-índice (
README.md,INDEX.md) em vez do código-alvo;Reenviam arquivos inteiros a cada turno da IA, desperdiçando 70% a 90% da janela de tokens.
Benchmarks Reais (Indexadores Monolíticos vs. Kaxcav Vortex v2.0.0-apex)
Métrica Operacional | Indexador RAG Monolítico | Kaxcav Vortex ( | Ganho Real |
Memória RAM (3 Repos Simultâneos) |
|
| -99.1% RAM |
Tamanho de Disco SQLite WAL |
|
| -99.9% Disco |
Admissão em Repo sem |
|
| Zero Lixo Indexado |
Latência de Contexto ( |
|
| ~500x mais rápido |
Precisão Top-1 (Benchmark Real) |
|
| 4x mais preciso |
Economia de Tokens por Chamada |
|
| ~82% a 88% economia |
Related MCP server: OpenCodeHub MCP Server
2. Arquitetura em 7 Camadas
flowchart LR
A["Worktree / Multi-Repo"] --> B["1. AdmissionFirewall (4KB Magic-Byte Sniffer)"]
B --> C["2. CodeStateMachine + PolyglotExtractor (CAS SHA-256)"]
C --> D["3. Sharded SQLite + FTS5 BM25F (32MB WAL Cap)"]
C --> E["4. TypedArray CSR Graph + PPR-HD (Hub Dampening)"]
D --> F["5. Submodular L0-L3 Slicer + Persistent ETag Delta"]
E --> F
F --> G["6. MultiRepoFederator + Contract Drift Detector"]
G --> H["7. CLI / MCP Server (10 Tools) / Web Workbench :7788"]Subsistema Core | Engenharia Aplicada |
| Inspeciona os primeiros |
| Scanner léxico de estados ( |
Camada tree-sitter opcional (src/parser/treesitter.ts) | Com o pacote opcional |
| 1 banco SQLite nativo ( |
| Grafo Compressed Sparse Row (CSR) em |
| Fatiamento cirúrgico em 4 níveis de fidelidade ( |
| Conecta rotas HTTP ( |
3. Instalação Zero-Dependency (30 Segundos)
Requisitos: Node.js
>= 22.13.0(recomendado Node.js24+, usanode:sqlitee--experimental-strip-typesnativos do Node). O núcleo não precisa denpm install; rodarnpm installsó acrescenta a camada tree-sitter opcional (mais 10 linguagens).Sistemas Operacionais: Windows (
kvx.cmd), Linux, macOS e WSL (./kvxounpm link).
git clone https://github.com/Kaxcav/kaxcav-vortex.git
cd kaxcav-vortex
npm link
# Validar suíte de testes completa (~1s)
npm test4. Guia Rápido de CLI (kvx)
# 1. Inicializar e registrar um repositório no Kaxcav Vortex
kvx init C:\caminho\do\meu-repo
# 2. Gerenciar múltiplos repositórios federados
kvx repo add C:\caminho\repo-backend
kvx repo add C:\caminho\repo-frontend
kvx repo list
# 3. Gerar pacote de contexto cirúrgico com orçamento de tokens (L0-L3)
kvx context --index C:\caminho\repo-backend --task "Fluxo de autenticacao JWT e permissoes" --token-budget 1800 --fidelity graded
# 4. Reutilizar ETag do turno anterior para colapsar símbolos inalterados em L0_DELTA
kvx context --index C:\caminho\repo-backend --task "Fluxo de autenticacao JWT e permissoes" --delta-from kvx-a1b2c3d4e5f60718
# 5. Inspecionar o esqueleto estrutural (L1 Outline) de um arquivo gastando ~40 tokens
kvx outline --index C:\caminho\repo-backend src/services/auth.ts
# 6. Ler apenas o código de uma função/classe específica sem carregar o arquivo inteiro
kvx symbol --index C:\caminho\repo-backend AuthService
# 7. Calcular Raio de Explosão (Blast Radius) e suítes de teste afetadas antes de commitar
kvx blast-radius --index C:\caminho\repo-backend AuthService
kvx affected --index C:\caminho\repo-backend -- src/services/auth.ts
# 8. Detectar quebras de assinatura (Contract Drift) nos arquivos recém-editados
kvx diff-impact --index C:\caminho\repo-backend --minutes 60
# 9. Descobrir contratos e rotas conectadas entre múltiplos repositórios
kvx federate --repos "C:\caminho\repo-backend,C:\caminho\repo-frontend"5. Web Workbench UI (kvx dashboard)
Suba a estação visual de engenharia para inspecionar os shards, testar o empacotador L0–L3, navegar pelo grafo CSR interativo em Canvas e auditar Contract Drifts:
kvx dashboard --port 7788Abra http://127.0.0.1:7788 no navegador. Você pode adicionar novos repositórios diretamente pelo campo + Repo na barra superior.
6. Integração MCP (Claude Code, Kimi Code, Cursor, Windsurf, Antigravity)
Adicione no seu mcp.json / claude_desktop_config.json:
{
"mcpServers": {
"kaxcav-vortex": {
"command": "node",
"args": [
"--experimental-strip-types",
"--no-warnings",
"/caminho/para/kaxcav-vortex/src/cli/main.ts",
"serve",
"--mcp"
]
}
}
}Para agentes que só devem ler código (por exemplo, o agy sem interface), registre também o servidor só de leitura:
"kaxcav-vortex-ro": {
"command": "node",
"args": ["--experimental-strip-types", "--no-warnings", "/caminho/para/kaxcav-vortex/src/cli/main.ts", "serve", "--mcp", "--read-only"]
}No agy, agy mcp add kaxcav-vortex-ro -- node --experimental-strip-types --no-warnings <main.ts> serve --mcp --read-only e uma regra só em ~/.gemini/antigravity-cli/settings.json: mcp(kaxcav-vortex-ro/*) (verificado em 08/11/2026). Nenhuma nexus_* fica exposta.
Ferramentas MCP (13; 10 no servidor só de leitura)
context: pacote de contexto ranqueado porPPR-HD+BM25Fcom fatiamentoL0–L3e suporte aif_none_match/delta_from.file_outline: esqueleto do arquivo com o intervalo real de cada símbolo;escopo=topo(padrão: módulo + membros de classe),exportadooutudo. Caminho absoluto ou relativo; se o arquivo não estiver indexado, diz por quê e sugere parecidos.read_symbol: só o trecho do símbolo; aceitanome,Classe.metodo,caminho#nomeepath. Sem resultado, devolve o motivo, nomes parecidos e ocorrências via busca textual.call_graph: chamadores diretos (callers) e funções chamadas (callees).diff_impact: Contract Drift de símbolos exportados (sem locais e sem testes) alterados na janela.blast_radius: impacto direto, transitivo, testes afetados e impactos cruzados entre repositórios.affected: seleção determinística de testes impactados por arquivos alterados.search/search_symbols: busca híbrida; responde comvia(indice/busca_textual/nenhum) e o motivo quando não acha.index_health: shards, WAL, idade do índice por arquivo (filepara um arquivo só) e tokens economizados.nexus_ingest_vault,nexus_query_sheet,nexus_audit_dlp(só no servidor completo).
.kvxignore
Caminhos que nenhuma ferramenta pode indexar nem ler, inclusive as nexus_*: um .kvxignore na raiz do repo (sintaxe do .gitignore) e um global em ~/.kvx/kvxignore (aceita caminhos absolutos). A recusa cita o arquivo, a linha e a regra.
Licença
Distribuído sob a licença MIT.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Hosted code graph over MCP: exact callers, dependencies, and cross-repo blast radius for AI agents.
The Cortex MCP server provides read-only access to real-time engineering context from the Cortex developer portal, allowing AI coding assistants to answer natural language questions about your organization's catalog (microservices, libraries, domains, teams, infrastructure), scorecards (engineering standards and best practices), initiatives (goals and deadlines), and Engineering Intelligence metrics. It includes tools for querying documentation, tracking personal entities, and accessing AI-assisted insights across the entire Cortex ecosystem.
Your org's AI agents, tasks, runs, search, and brain files as MCP tools and resources.
Code intelligence platform for AI agents. 20 tools for architecture, security & impact analysis.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to search code by meaning, explore codebase structure, store and query knowledge with temporal facts, and read source code through a set of MCP tools.7MIT
- AlicenseNot gradedqualityCmaintenanceProvides code intelligence for AI coding agents by indexing repositories into a hybrid knowledge graph, enabling agents to query dependencies, impact, and context through 28 MCP tools.4Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to perform hybrid semantic and lexical code search across multiple repositories, retrieve symbol definitions and call hierarchies, and manage repository relations through MCP tools.Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables AI coding agents to query code structure efficiently through 16 MCP tools, including symbol lookup, full-text search, dependency analysis, and refactor planning, powered by tree-sitter parsing and index-backed code intelligence.3MIT