Cerebro MCP

Un sistema de memoria cognitiva implementado como servidor MCP que almacena datos en Supabase. Proporciona almacenamiento persistente en diferentes instalaciones de Claude para grafos de conocimiento, con compatibilidad con entidades y relaciones.

Aviso

Esto es un trabajo en desarrollo, así que no esperes que funcione a la perfección sin algunos ajustes. Estaba usando el servidor de memoria MCP, pero quería que funcionara con Claude instalado en diferentes computadoras simultáneamente. Improvisé un proceso de transferencia y me pareció absurdo, así que lo trasladé a Supabase. Funciona una vez que lo tienes en funcionamiento, pero la instalación no está tan bien hecha como debería. Recomiendo encarecidamente configurarlo primero en VSC con Cline Dev o algo similar en lugar de intentar que funcione primero en Claude Desktop. He conseguido instalar Claude Desktop y VSC en dos portátiles diferentes y en un VPS, todos compartiendo la misma base de datos de Supabase.

Características

• Almacenamiento persistente mediante Supabase
• Estructura del gráfico de conocimiento con entidades y relaciones
• Bloqueo a nivel de base de datos para un acceso concurrente seguro
• Compatibilidad multiplataforma (MacOS, Linux, Windows)
• Inicialización automática de tablas
• Soporte de registro de depuración

Prerrequisitos

• Node.js y npm
• VSCode con la extensión Claude
• Uno de los siguientes:
  • Una nueva cuenta y proyecto de Supabase (para la instalación principal)
  • Credenciales de Supabase de una instalación existente (para instalaciones secundarias)

Tipos de instalación

Seleccione el tipo de instalación adecuado:

1. Instalación principal : Configure mcp-brain con un nuevo proyecto de Supabase. Esto es para la primera máquina que usará el cerebro.
2. Instalación secundaria : Instale mcp-brain en otras máquinas que utilicen la misma base de datos Supabase. Esto permite que varias máquinas compartan el mismo gráfico de conocimiento.

Instalación

El proceso de instalación implica compilar el proyecto y configurarlo con sus credenciales de Supabase. Puede hacerlo automáticamente mediante el script proporcionado o manualmente.

Instalación primaria

Para su primera instalación de mcp-brain:

1. Crea un nuevo proyecto de Supabase en https://supabase.com
2. Obtén la URL de tu proyecto y la clave API desde Configuración del proyecto > API
3. Siga los pasos de instalación automáticos o manuales a continuación
4. Guarde sus credenciales de Supabase para usarlas en instalaciones secundarias

Instalación secundaria

Para instalar mcp-brain en máquinas adicionales:

1. Obtenga la URL de Supabase y la clave API de su instalación principal
2. Siga los pasos de instalación automáticos o manuales a continuación
3. Utilice las mismas credenciales para garantizar que todas las instancias compartan el mismo gráfico de conocimiento

Opción A: Instalación automatizada

1. Clonar y construir el proyecto:
   git clone https://github.com/gtrusler/mcp-brain.git cd mcp-brain npm install npm run build
2. Ejecute el script de configuración:
   npm run configure
   Se le solicitará que ingrese la URL de Supabase y la clave API. El script realizará automáticamente lo siguiente:
   • Cree o actualice el archivo de configuración MCP para su sistema operativo
   • Configurar las rutas correctas a los archivos compilados
   • Conservar cualquier configuración de servidor MCP existente

Opción B: Instalación manual

1. Clonar y construir el proyecto:
   git clone https://github.com/gtrusler/mcp-brain.git cd mcp-brain npm install npm run build
2. Localice su archivo de configuración MCP:
   • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Windows: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
3. Agregue o actualice la configuración de mcp-brain en el archivo de configuración:
   { "mcpServers": { "mcp-brain": { "command": "node", "args": ["path/to/mcp-brain/dist/index.js"], "env": { "SUPABASE_URL": "your-project-url", "SUPABASE_KEY": "your-api-key", "DEBUG": "false" } } } }
   Reemplazar:
   • path/to/mcp-brain con la ruta absoluta a donde clonó y construyó el repositorio
   • your-project-url con la URL de su proyecto Supabase
   • your-api-key con su clave API de Supabase

   Nota: Si el archivo de configuración ya existe, asegúrese de conservar las configuraciones del servidor MCP. Solo agregue o actualice la sección mcp-brain dentro del objeto mcpServers.

Sus credenciales de Supabase se pueden encontrar en la configuración de su proyecto Supabase en Configuración del proyecto > API.

Aplicar cambios

Después de la instalación o cualquier cambio de configuración:

1. Si VSCode está abierto:
   • Cerrar todas las conversaciones de Claude
   • Ejecute el comando "Desarrollador: Recargar ventana" (Cmd/Ctrl + Shift + P, luego escriba "reload")
2. Si VSCode está cerrado:
   • Simplemente inicie VSCode y la nueva configuración se cargará automáticamente

Verificación de la instalación

Después de volver a cargar VSCode, verifique la configuración mediante lo siguiente:

1. Creando una nueva conversación con Claude
2. Ejecutar un comando como Can you use your brain? para probar la conexión
3. El cerebro debe responder con información sobre sus capacidades.

Uso

El cerebro proporciona tres herramientas principales a través del protocolo MCP:

1. read_graph : Lee el gráfico de conocimiento completo
2. create_entities : Almacena nuevos recuerdos como entidades
3. create_relations : Crea conexiones entre memorias

Estas herramientas pueden ser utilizadas a través de Claude para almacenar y recordar información de forma persistente.

Desarrollo

• npm run build - Construye el proyecto TypeScript
• npm run configure : configurar las credenciales de Supabase
• npm start : inicia el servidor MCP directamente (normalmente no es necesario)

Arquitectura

• Utiliza TypeScript y @modelcontextprotocol/sdk
• Almacena datos en tablas de Supabase:
  • entidades: Nodos en el gráfico de conocimiento
  • relaciones: Aristas que conectan entidades
  • bloqueos: bloqueo a nivel de base de datos para acceso concurrente
• Creación automática de tablas en la primera ejecución
• Configuración independiente de la plataforma

Licencia

Instituto Tecnológico de Massachusetts (MIT)