Sincronización de memoria myAI

¿Cansado de repetirle lo mismo a Claude cada vez que inicias un nuevo chat? myAI Memory Sync es una revolucionaria herramienta MCP que sincroniza a la perfección tus preferencias, información personal y estándares de código en todas tus interfaces de Claude. Con solo una actualización, tus cambios aparecerán al instante en todas partes: desde Claude Desktop hasta Claude Code, Windsurf y la web de Claude.ai. ¡Con nuestro innovador sistema de caché, las consultas relacionadas con la memoria son hasta 2000 veces más rápidas! Deja de malgastar tokens en instrucciones repetitivas y disfruta de una experiencia de IA verdaderamente personalizada.

Cómo se compara myAImemory-mcp con otras herramientas de memoria

Si bien existen varias herramientas de memoria excelentes para sistemas de IA, myAImemory-mcp tiene un propósito específico como herramienta de Protocolo de Contexto de Modelo (MCP):

Herramienta	Enfoque principal	Modelo de privacidad	Integración	Fuerza única
miAImemory-mcp	Preferencias del usuario en las interfaces de Claude	Local primero, no se envían datos a servidores externos	MCP específico de Claude	Sincronización multiplataforma con almacenamiento en caché de alto rendimiento
Grafiti	Gráficos de conocimiento temporal	dependiente de la base de datos	Marco del agente general	Conciencia temporal en la representación del conocimiento
Letta/MemGPT	Marco de agente con estado	Basado en servidor	Soporte multimodelo	Arquitectura completa del agente
Mem0	Interacciones de IA personalizadas	Basado en API	Multiplataforma	Jerarquía de memoria de múltiples niveles
Memoria	Memoria similar a la humana para agentes	Base de datos de gráficos	Centrado en el agente	Emulación de la memoria humana
Cognee	Memoria confiable para aplicaciones de IA	Múltiples opciones de almacenamiento	Canalización de datos centrada en el cliente	Amplia integración de fuentes de datos

Ventajas clave de myAImemory-mcp:

Privacidad primero : todos los datos permanecen en su dispositivo y no se envía información personal a servidores externos.
Rendimiento : aprovecha las capacidades de almacenamiento en caché de Claude para lograr mejoras de velocidad espectaculares
Simplicidad : actualizaciones de lenguaje natural según sus preferencias en todas las interfaces de Claude
Integración MCP : Diseñado específicamente como un MCP de Claude para una integración perfecta

🚀 Inicio rápido

# Clone repository
git clone https://github.com/Jktfe/myaimemory-mcp.git
cd myaimemory-mcp

# Install dependencies
npm install

# Build TypeScript code
npm run build

# Start MCP server
./start-memory-sync.sh

Método de sincronización directa (alternativa sencilla)

Para un enfoque más simple que no requiere ejecutar un servidor MCP, puede utilizar el script de sincronización independiente:

# One-time sync of all memory files
node sync-memory.js

Este script hará lo siguiente:

Lea desde su archivo "myAI Master.md"
Actualice todos los archivos CLAUDE.md en sus proyectos
Actualiza la configuración de memoria de tu Windsurf
Todo sin almacenar información confidencial en el repositorio git

🔒 Privacidad y seguridad

El archivo "myAI Master.md" con su información personal está excluido del seguimiento de Git
Todos los archivos CLAUDE.md también están excluidos para proteger su privacidad.
Utilice el .gitignore incluido para garantizar que los archivos confidenciales permanezcan privados

Luego en Claude, simplemente di:

You: Use myAI Memory to remember I prefer TypeScript over JavaScript
Claude: ✅ Added to your Coding Preferences! I'll remember you prefer TypeScript over JavaScript.

📋 Opciones de instalación

Opción 1: Instalación directa (recomendada)

Instalar desde npm:

npm install -g myai-memory-sync

Iniciar el servidor:

myai-memory-sync

Opción 2: Ejecutar desde la fuente

Clonar y compilar desde la fuente:

git clone https://github.com/Jktfe/myaimemory-mcp.git
cd myaimemory-mcp
npm install
npm run build
npm start

Opción 3: Docker

Construir y ejecutar con Docker:

docker build -t myai-memory-sync .
docker run -v myai-memory:/app/data -p 3000:3000 myai-memory-sync

🔌 Configuración de MCP

Configuración del escritorio de Claude

Agregue esto a su claude_desktop_config.json :

{
  "mcpServers": {
    "myai-memory-sync": {
      "command": "npx",
      "args": [
        "-y",
        "myai-memory-sync"
      ],
      "env": {
        "TEMPLATE_PATH": "/path/to/custom/template.md",
        "ENABLE_ANTHROPIC": "true",
        "ANTHROPIC_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude.ai con Smithery

Visita Smithery.ai
Agregue el MCP de sincronización de memoria myAI:
@Jktfe/myaimemory-mcp
Configure con su clave API en la configuración de Smithery

Integración de windsurf

En Windsurf, agregue a su .codeium/config.json :

{
  "mcp": {
    "servers": {
      "myai-memory-sync": {
        "command": "npx",
        "args": [
          "-y",
          "myai-memory-sync"
        ]
      }
    }
  }
}

Modo de servidor HTTP

Para el transporte HTTP en lugar de stdio:

# Start HTTP server on port 3000
npm run start:http

# Or specify a custom port
PORT=8080 npm run start:http

Variables de entorno

Crea un archivo .env con las siguientes opciones:

# Basic configuration
DEBUG=true                      # Enable debug logging
TEMPLATE_PATH=./data/template.md  # Custom template location

# Platform-specific paths
WINDSURF_MEMORY_PATH=~/.codeium/windsurf/memories/global_rules.md
CLAUDE_PROJECTS_PATH=~/CascadeProjects

# Performance optimization
ENABLE_ANTHROPIC=true           # Enable Anthropic API integration
ANTHROPIC_API_KEY=your-api-key  # Your Anthropic API key
ENABLE_PROMPT_CACHE=true        # Enable prompt caching system
CACHE_TTL=300000                # Cache TTL in milliseconds (5 minutes)

# Claude web sync (optional)
CLAUDE_WEB_SYNC_ENABLED=false   # Enable Claude.ai web synchronization
CLAUDE_WEB_EMAIL=you@email.com  # Your Claude.ai email
CLAUDE_WEB_HEADLESS=true        # Run browser in headless mode

🧙‍♂️ Integración de indicaciones del sistema

Para obtener mejores resultados, agregue esto al mensaje del sistema Claude:

Memory Integration Instructions:
When you receive a command that starts with "use myAI Memory to", you should:

1. Process the rest of the instruction as a memory management command
2. Try to determine the appropriate section to update based on the content
3. Use the myAI Memory Sync MCP to update your memory
4. Confirm the update with a brief acknowledgment

For example:
"use myAI Memory to remember I prefer dark mode" 
→ Update the preferences section with dark mode preference

When asked questions about preferences or personal information, first check your memory via the myAI Memory Sync MCP. Always reference information from memory rather than making assumptions.

✨ Características

🔄 Sincronización entre plataformas : se actualiza una vez y se sincroniza en todas partes
⚡ Recuperación ultrarrápida : sistema de almacenamiento en caché con un aumento de rendimiento de hasta 2000 veces
🗣️ Interfaz de lenguaje natural : simplemente habla con naturalidad para actualizar tus preferencias
🧩 Múltiples perfiles de persona : cambia entre diferentes ajustes preestablecidos con facilidad
🔐 Centrado en la seguridad : almacenamiento local con protección .gitignore
🛠️ Fácil de usar para desarrolladores : implementación completa de TypeScript con API integral

🧩 Arquitectura central

myAI Memory Sync utiliza una arquitectura modular con estos componentes clave:

Analizador de plantillas : conversión bidireccional entre objetos de memoria estructurada y Markdown
Almacenamiento de plantillas : almacenamiento persistente con caché en memoria y sistema de archivos
Sincronizadores de plataforma : implementa la interfaz PlatformSyncer para cada plataforma de destino
Procesador de lenguaje natural : extrae datos estructurados de los comandos de memoria de lenguaje natural
Servicio de caché de memoria : optimiza el rendimiento con estrategias de almacenamiento en caché de varios niveles

🔍 Características detalladas

Sincronización entre plataformas

ClaudeCodeSyncer : actualiza los archivos CLAUDE.md en todos los repositorios
WindsurfSyncer : administra global_rules.md en el entorno de Windsurf
ClaudeWebSyncer : sincronización opcional basada en Puppeteer con la interfaz web de Claude.ai

Gestión inteligente de memoria

Extracción basada en patrones : convierte el lenguaje natural en pares clave-valor estructurados
Algoritmo de detección de sección : determina automáticamente la sección apropiada para nuevas memorias
Formato de plantilla de memoria : Estructura basada en Markdown con secciones, descripciones y elementos clave-valor
Preservación del contexto : actualiza las secciones de memoria mientras conserva el resto del contenido de la plantilla

Optimización del rendimiento

Almacenamiento en caché de varios niveles : almacenamiento en caché en memoria tanto a nivel de plantilla como de sección
Gestión de caché basada en TTL : tiempo de vida configurable para el contenido almacenado en caché
Precalentamiento : precarga de caché después de las actualizaciones de plantillas
Integración de API antrópica opcional : acelera las consultas relacionadas con la memoria hasta 2000 veces

Seguridad

Arquitectura local primero : todos los datos permanecen en su dispositivo
Gestión de Gitignore : agrega automáticamente CLAUDE.md a .gitignore en todos los repositorios
Manejo de permisos de archivos : corrige problemas de permisos para lograr la máxima compatibilidad
Almacenamiento cifrado : compatible con sistemas de archivos cifrados

Formato de plantilla de memoria

El sistema utiliza un formato de rebajas estructurado para organizar sus preferencias:

# myAI Memory

# User Information
## Use this information if you need to reference them directly
-~- Name: Your Name
-~- Location: Your Location
-~- Likes: Reading, Hiking, Technology

# General Response Style
## Use this in every response
-~- Style: Friendly and concise
-~- Use UK English Spellings: true
-~- Include emojis when appropriate: true

# Coding Preferences
## General Preference when responding to coding questions
-~- I prefer TypeScript over JavaScript
-~- Show step-by-step explanations

🛠️ Implementación técnica

Esquema de plantilla de memoria

interface MemoryTemplate {
  sections: TemplateSection[];
}

interface TemplateSection {
  title: string;
  description: string;
  items: TemplateItem[];
}

interface TemplateItem {
  key: string;
  value: string;
}

Interfaz de sincronización de plataformas

interface PlatformSyncer {
  sync(templateContent: string): Promise<SyncStatus>;
}

type PlatformType = 'claude-web' | 'claude-code' | 'windsurf' | 'master';

interface SyncStatus {
  platform: PlatformType;
  success: boolean;
  message: string;
}

🔌 API de integración de MCP

La herramienta myAI Memory Sync implementa el Protocolo de Contexto de Modelo (MCP) con las siguientes funciones:

Función	Descripción	Parámetros
`get_template`	Recupera la plantilla de memoria completa	Ninguno
`get_section`	Recupera una sección específica	`sectionName: string`
`update_section`	Actualiza una sección específica	`sectionName: string, content: string`
`update_template`	Reemplaza toda la plantilla	`content: string`
`list_presets`	Enumera los ajustes preestablecidos disponibles	Ninguno
`load_preset`	Carga un ajuste preestablecido específico	`presetName: string`
`create_preset`	Crea un nuevo ajuste preestablecido	`presetName: string`
`sync_platforms`	Se sincroniza entre plataformas	`platform?: string`
`list_platforms`	Enumera las plataformas disponibles	Ninguno

Interfaz de lenguaje natural

Los usuarios pueden interactuar con el sistema a través de comandos en lenguaje natural:

You: Use myAI Memory to remember I prefer TypeScript over JavaScript
Claude: ✅ Added to your Coding Preferences! I'll remember you prefer TypeScript over JavaScript.

You: Use myAI Memory to load preset developer
Claude: ✅ Loaded developer preset! I'll now use your developer preferences.

🧙‍♂️ Uso avanzado

Ajustes preestablecidos de memoria

Cambia entre diferentes personajes fácilmente:

You: Use myAI Memory to list presets
Claude: Available presets: personal, work, developer

You: Use myAI Memory to load preset developer
Claude: ✅ Loaded developer preset!

Sincronización de emergencia

Cuando necesite solucionar problemas de sincronización en todas las plataformas:

# Sync everything immediately
./emergency-sync.sh

Interfaz de línea de comandos

# View all available commands
node dist/cli.js --help

# Process memory commands directly
node dist/cli.js --remember "remember I prefer dark mode"

# Start HTTP server for SSE transport
npm run start:http

# Start stdio server for MCP transport
npm run start

Flujo de trabajo de desarrollo

# Run in development mode with auto-reload
npm run dev

# Run in development mode with HTTP server
npm run dev:http

# Watch TypeScript compilation
npm run build:watch

# Run tests
npm test

# Run specific test
npm test -- -t "platformSync"

# Lint code
npm run lint

# Type check without emitting files
npm run typecheck

⚡ Puntos de referencia de rendimiento

Nuestro sistema de almacenamiento en caché ofrece increíbles mejoras de rendimiento:

Operación	Sin caché	Con caché	Mejora
Consulta de memoria	~2000 ms	~1 ms	2000x
Búsqueda de sección	~1600 ms	~0,8 ms	2000x
Análisis de plantillas	~120 ms	~0,1 ms	1200x
Sincronización de plataforma	~850 ms	~350 ms	2,4x

🔒 Seguridad y privacidad

Nos tomamos su privacidad muy en serio:

Todos los datos permanecen localmente en su dispositivo
Los archivos CLAUDE.md se agregan automáticamente a .gitignore
No se envían datos a servidores externos (excepto cuando se utiliza la integración opcional de API Anthropic)
Funciona con sistemas de archivos cifrados para máxima seguridad.

🛠️ Solución de problemas

Problemas comunes

CLAUDE.md no se actualiza
- Compruebe los permisos de archivo con ls -la CLAUDE.md
- Pruebe la sincronización de emergencia con ./emergency-sync.sh
- Verifique las rutas de la plataforma en su archivo .env
Fallas de conexión MCP
- Asegúrese de que el servidor MCP se esté ejecutando con ps aux | grep myai-memory
- Consulte los registros de Claude Desktop para detectar errores de MCP
- Verifique su archivo de configuración de Claude Desktop
Problemas de almacenamiento en caché
- Limpiar la caché con node dist/cli.js --clear-cache
- Verifique que la clave API de Anthropic esté configurada correctamente
- Verifique la integridad del archivo de memoria con node dist/cli.js --validate

Registros y depuración

Habilite el modo de depuración para ver registros detallados:

DEBUG=true npm run start

Los archivos de registro se almacenan en:

Linux/macOS: ~/.local/share/myai-memory/logs/
Ventanas: %APPDATA%\myai-memory\logs\

🤝 Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

Seguimos un flujo de trabajo Git estándar y un proceso CI:

Todas las relaciones públicas requieren pasar pruebas y pelusas
Las nuevas funciones deberían incluir pruebas
Los cambios importantes deberían actualizar la documentación
Seguir el estilo y los patrones de código existentes

📚 Documentación

Para obtener documentación más detallada, consulte la Wiki .

La documentación de la API está disponible en el directorio /docs :

# Generate API documentation
npm run docs

📄 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

📬 Contacto

Enlace del proyecto: https://github.com/Jktfe/myaimemory-mcp

Integrations