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):

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

Related MCP server: Union MCP

🚀 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

1. Visita Smithery.ai

2. Agregue el MCP de sincronización de memoria myAI:

   @Jktfe/myaimemory-mcp

3. 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:

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:

🔒 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

1. 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

2. 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

3. 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.

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

5. 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