cerebro
Cérebro 2.0
Servidor de optimización de contexto para OpenCode. Comprime los prompts de LLM mediante LLMLingua-2, inyecta protocolos de tarea y proporciona un grafo de conocimiento del 2nd Brain.
Arquitectura
┌─────────────────────────────────────────────────┐
│ OpenCode │
│ ┌──────────────┐ ┌──────────────────────────┐ │
│ │ Plugin │ │ MCP Client │ │
│ │ (hooks) │ │ (tools) │ │
│ └──────┬───────┘ └────────────┬─────────────┘ │
│ │ │ │
└─────────┼───────────────────────┼────────────────┘
│ │
┌─────▼─────┐ ┌──────▼──────┐
│ Compressor │ │ MCP Server │
│ LLMLingua-2│ │ + HTTP API │
└─────┬─────┘ └──────┬──────┘
│ │
┌─────▼───────────────────────▼──────┐
│ @cerebro/core │
│ compressor · task-injector · brain │
└────────────────────────────────────┘Paquetes
Paquete | Descripción |
| Motor de compresión, inyector de tareas, motor cerebral y métricas |
| Servidor MCP stdio + API HTTP para el panel |
| Plugin de OpenCode (compresión de mensajes + inyección de tareas) |
| Interfaz de dashboard con Vite + React + Tailwind |
Related MCP server: repocontext
Inicio rápido
# Install dependencies
pnpm install
# Approve native builds (onnxruntime-node)
pnpm approve-builds
# Run tests
pnpm test
# Build all packages
pnpm -r build
# Start MCP server (stdio for OpenCode)
node packages/mcp-server/dist/index.js
# Start dashboard dev server
pnpm --filter @cerebro/dashboard devConfiguración
Variables de entorno (definidas en opencode.json, dentro de environment):
Variable | Valor por defecto | Descripción |
|
| Tasa de compresión (0.05–1.0; menor = más compresión) |
|
| Ruta a la base de conocimientos del 2nd Brain |
|
| Puerto de la API HTTP para el dashboard |
|
| Activa la inyección de protocolos de tarea |
|
| Patrones de bloques protegidos separados por comas |
Integración con OpenCode
Añade en opencode.json en la raíz de tu proyecto:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"cerebro": {
"type": "local",
"command": ["node", "caminho/para/cerebro/packages/mcp-server/dist/index.js"],
"environment": {
"COMPRESSION_RATE": "0.4",
"BRAIN_PATH": ".context-brain",
"DASHBOARD_PORT": "4321",
"ENABLE_TASK_INJECTION": "true"
},
"enabled": true
}
}
}Herramientas MCP
compress_prompt
Comprime texto mediante LLMLingua-2 ONNX.
{ "text": "Your long prompt...", "rate": 0.4 }brain_resolve
Consulta el 2nd Brain para obtener una pantalla y sus dependencias vinculadas por wiki.
{ "screen": "dashboard-vendas", "depth": 1 }brain_index
Indexa o actualiza una pantalla en el grafo de conocimiento.
{
"id": "dashboard-vendas",
"content": "---\ntitle: Dashboard Vendas\n---\n\n# Dashboard Vendas\n\nMetrics for the sales dashboard."
}brain_screens
Lista todas las pantallas indexadas. Sin parámetros.
cerebro_metrics
Obtiene las métricas de compresión y el ahorro de tokens. Sin parámetros.
cerebro_config
Obtiene o establece la configuración en tiempo de ejecución.
{ "key": "compressionRate", "value": 0.3 }Dashboard
El dashboard se ejecuta en el puerto 4321 y ofrece:
Métricas: Estadísticas de compresión, ahorro de tokens y eventos recientes
2º Cérebro: Explora las pantallas indexadas y sus enlaces wiki
Config: Ver y editar la configuración en tiempo de ejecución
pnpm --filter @cerebro/dashboard dev
# Open http://localhost:4321Hooks del plugin
El plugin de OpenCode ofrece tres hooks:
Hook | Descripción |
| Comprime los mensajes antiguos antes de enviarlos al LLM |
| Inyecta el protocolo de tareas y la autoverificación en el prompt del sistema |
| Registra la ejecución de herramientas para su visibilidad en el panel |
Desarrollo
# Type check all packages
pnpm -r typecheck
# Run tests
pnpm test
# Watch mode
npx vitest
# Build dashboard
pnpm --filter @cerebro/dashboard buildPruebas
66 pruebas en 6 suites:
packages/core/src/ task-injector.test.ts (18) · metrics.test.ts (5)
packages/mcp-server/src/ errors.test.ts (9) · rate-limiter.test.ts (7) · e2e.test.ts (10)
packages/plugin/src/ plugin.test.ts (8)Ejecutar con: pnpm test o npx vitest run
Licencia
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Intelligent context infrastructure for AI teams: knowledge graph, sessions, tasks, documents.
Shared memory for coding agents. Stop re-explaining your codebase every session.
Research-backed lint + generation for agent context files (CLAUDE.md, AGENTS.md) + prompt enhancer.
Shared project context for AI agents and teams: docs, tasks, and messages that stay current.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides intelligent code context and analysis through semantic compression, AST parsing, and multi-language support. Offers 60-80% token reduction while enabling AI assistants to understand codebases through local analysis, OpenAI-enhanced insights, and GitHub repository integration.617 npm3MIT
- AlicenseAqualityAmaintenanceNext-gen AST codebase map, token compression (70%~85% savings), and context packaging engine for AI coding agents & IDEs.43MIT
- AlicenseNot gradedqualityBmaintenanceEnables autonomous context window management, prompt caching, token optimization, and real-time observability for AI coding agents across multiple IDEs, reducing token costs and improving performance.Apache 2.0
- AlicenseBqualityBmaintenanceEnables AI coding agents and local LLMs to store and recall project memory, compact verbose logs, look up code symbols, create and rewind workspace snapshots, detect risky commands and loops, pack context optimally, and draft tokens through MCP tools.102Apache 2.0