Simple Memory MCP

Un sistema de gestión de memoria para asistentes de IA que permite almacenar, recuperar y gestionar información del usuario mediante una base de datos local.

GitHub

Prueba este MCPPatrocinado

Documentación

Simple Memory MCP

English | 中文

Español

Descripción General

Simple Memory MCP es un sistema de gestión de memoria diseñado para asistentes de IA, que implementa el Protocolo de Contexto de Modelo (MCP) para proporcionar capacidades de almacenamiento y recuperación de memoria persistente.

Métodos de Uso Comunes - Características

1. Abrir Interfaz de Gestión Web

Dile a tu asistente de IA: "Abrir memoria" o "Abrir memoria WEB", la IA:

Iniciará automáticamente el servidor web
Abrirá el navegador predeterminado
Mostrará la interfaz de gestión visual

2. Obtener Lista de Memorias

Dile a tu asistente de IA: "Obtener todas las memorias" o "Mostrar lista de memorias", la IA ejecutará la herramienta list_memory_titles para recuperar todos los títulos de memoria.

3. Obtener Contenido de Memoria Específica

Dile a tu asistente de IA: "Obtener el contenido de la memoria 'XXX' y ejecutar", la IA ejecutará la herramienta get_memory_by_title para recuperar el contenido completo de la memoria especificada.

4. Almacenar Nueva Memoria

Dile a tu asistente de IA: "Ayúdame a almacenar una memoria", la IA:

Primero te pedirá que proporciones el título de la memoria
Luego te pedirá que ingreses el contenido de la memoria
Ejecutará la herramienta store_memory para completar el almacenamiento

Características

Almacenamiento Inteligente de Memoria: Los asistentes de IA deben primero preguntar a los usuarios por los títulos de memoria, luego solicitar el contenido
📋 Recuperación Eficiente: Las herramientas MCP optimizadas devuelven solo datos esenciales (título + marca de tiempo) para un mejor rendimiento
🌐 Interfaz de Gestión Web: Gestión visual intuitiva con operaciones CRUD completas
🔍 Búsqueda de Texto Completo: Busca tanto en títulos como en contenido
🎯 Gestión Inteligente de Puertos: Detección automática de puertos y resolución de conflictos
📱 Diseño Responsivo: Optimizado para dispositivos de escritorio y móviles
🔒 Diseño de Instancia Única: La detección automática previene múltiples instancias del servidor
🤝 Soporte Multi-IA: Múltiples asistentes de IA pueden compartir de forma segura la misma instancia del servidor

Inicio Rápido

Clonar Repositorio

# Clone the repository
git clone https://github.com/eragonht1/simple-memory-mcp.git

# Navigate to project directory
cd simple-memory-mcp

Requisitos Previos

Node.js 16.0.0 o superior
Mínimo 512MB de RAM
100MB de almacenamiento disponible

Guía de Instalación de Node.js

Para Usuarios de Windows:

Visita el sitio web oficial de Node.js
Descarga la versión LTS (Soporte a Largo Plazo)
Ejecuta el instalador (archivo .msi)
Sigue el asistente de instalación con la configuración predeterminada
Reinicia tu computadora después de la instalación

Para Usuarios de macOS:

# Option 1: Download from official website
# Visit https://nodejs.org/ and download the LTS version

# Option 2: Using Homebrew (recommended)
brew install node

Para Usuarios de Linux:

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm

# Arch Linux
sudo pacman -S nodejs npm

Verificar Instalación:

# Check Node.js version
node --version

# Check npm version
npm --version

Ambos comandos deberían devolver números de versión (por ejemplo, v18.17.0 para Node.js).

Instalación

# Install dependencies
npm install

# Initialize database
npm run init-db

Iniciar Servicios

# Start MCP Server
npm start

# Start Web Interface (recommended)
node start-web.js
# or
npm run web

Acceder a la Interfaz Web

URL predeterminada: http://localhost:8011
El sistema detectará y asignará automáticamente los puertos disponibles
El navegador se abrirá automáticamente con el lanzador profesional

Configuración del Asistente de IA

Plantilla de Configuración Universal

Usa la siguiente plantilla de configuración para cualquier asistente de IA que admita MCP:

{
  "mcpServers": {
    "simple-memory": {
      "command": "node",
      "args": ["./start-mcp.js"],
      "cwd": "/path/to/your/simple-memory-mcp"
    }
  }
}

Pasos de Configuración:

Reemplaza /path/to/your/simple-memory-mcp con la ruta real de tu proyecto
Agrega esta configuración al archivo de configuración MCP de tu asistente de IA
Reinicia tu asistente de IA para cargar la nueva configuración

Nota: El script start-mcp.js proporciona un mejor manejo de errores y una salida más amigable para el usuario en comparación con llamar directamente a src/server.js.

🔒 Diseño de Instancia Única

Simple Memory MCP utiliza un diseño de instancia única para garantizar un uso óptimo de recursos y consistencia de datos:

Detección Automática: Antes de iniciar, el sistema verifica si ya hay un servidor MCP en ejecución
Compartición Inteligente: Múltiples asistentes de IA (Claude, Augment, etc.) pueden compartir de forma segura la misma instancia del servidor
Eficiencia de Recursos: Previene procesos de servidor duplicados y conflictos de base de datos
Experiencia Fluida: Si un servidor ya está en ejecución, las nuevas conexiones de IA usarán automáticamente la instancia existente

Flujo de Trabajo Multi-IA:

Primera IA inicia → Detecta que no hay servidor → Inicia un nuevo servidor MCP → Se conecta exitosamente
Segunda IA inicia → Detecta el servidor existente → Muestra un mensaje amigable → Se conecta a la instancia existente
Ambas IAs pueden usar las funciones de memoria simultáneamente sin conflictos
Cuando todas las IAs se cierran → El servidor MCP se apaga automáticamente para liberar recursos

Ejemplos de Uso

A Través del Asistente de IA

User: Help me store a memory
AI: Please provide the title for this memory:
User: Study Notes - MCP Protocol
AI: Please enter the memory content:
User: [Enter content]
AI: Memory "Study Notes - MCP Protocol" has been successfully stored!

¡NUEVO! Inicio Automático de la Interfaz Web

Simplemente di cualquiera de estas frases de activación a tu asistente de IA:

"打开记忆MCP" (Abrir Memoria MCP)
"打开记忆" (Abrir Memoria)
"打开记忆WEB" (Abrir Memoria WEB)
"开启记忆" (Iniciar Memoria)

La IA automáticamente:

🚀 Iniciará el servidor web (si no está en ejecución)
🌐 Abrirá tu navegador predeterminado
📋 Mostrará la interfaz de gestión de memoria
✨ Proporcionará consejos de uso y URLs de acceso

A Través de la Interfaz Web

Haz clic en "➕ Agregar Memoria" para crear nuevas memorias
Haz clic en las tarjetas de memoria para ver los detalles
Usa los botones de acción en cada tarjeta de memoria:
- Editar (🖊️) - Modificar el contenido de la memoria
- Copiar (📋) - Copiar título y contenido al portapapeles en texto plano
- Eliminar (🗑️) - Eliminar la memoria permanentemente
Usa el cuadro de búsqueda para encontrar contenido específico
Arrastra y suelta las tarjetas de memoria para reordenarlas

Herramientas MCP

store_memory - Almacenar nueva memoria (requiere título y contenido)
list_memory_titles - Obtener lista de todos los títulos de memoria
get_memory_by_title - Recuperar contenido de memoria por título
delete_memory - Eliminar memoria especificada
open_memory_web - ¡NUEVO! Abrir la interfaz web de gestión de memoria con inicio automático del navegador

Documentación

Para documentación detallada, consulta DOCS.md que incluye:

Documentación completa de la API
Guía de implementación
Documentación de desarrollo
Sistema de gestión de puertos
Guía de usuario

Solución de Problemas

Conflictos de puertos:

# Windows
netstat -ano | findstr :8011
taskkill /PID <PID> /F

# Linux/macOS
lsof -i :8011
kill -9 <PID>

Problemas de base de datos:

rm data/memories.db
npm run init-db

Problemas de inicio automático de la interfaz web:

# If browser doesn't open automatically
# Check if the web server is running
curl http://localhost:8011

# Manually open the URL shown in AI response
# Example: http://localhost:8011

# Check browser availability (Linux)
which xdg-open firefox google-chrome

# Check browser availability (Windows)
where start

# Check browser availability (macOS)
which open

中文

概述

Simple Memory MCP 是一个专为AI助手设计的记忆管理系统，实现了模型上下文协议（MCP），为AI助手提供持久化记忆存储和检索功能。

常见使用方法-功能特性

1. 开启Web管理界面

对AI助手说："开启记忆"或"打开记忆WEB"，AI会：

自动启动Web服务器
打开默认浏览器
显示可视化管理界面

2. 获取记忆列表

对AI助手说："获取所有记忆"或"显示记忆列表"，AI会执行 list_memory_titles 工具获取所有记忆标题。

3. 获取特定记忆内容

对AI助手说："获取'XXX'记忆内容并执行"，AI会执行 get_memory_by_title 工具获取指定记忆的完整内容。

4. 存储新记忆

对AI助手说："帮我存储一个记忆"，AI会：

先要求您提供记忆标题
再要求您输入记忆内容
执行 store_memory 工具完成存储

功能特性

智能记忆存储: AI助手必须先要求用户提供记忆标题，再要求输入内容
📋 高效检索: 优化的MCP工具只返回必要数据（标题+时间戳），提升性能
🌐 Web管理界面: 直观的可视化管理界面，支持完整的增删改查操作
🔍 全文搜索: 支持标题和内容的关键词搜索
🎯 智能端口管理: 自动端口检测和冲突解决
📱 响应式设计: 针对桌面端和移动端进行优化
🔒 单实例设计: 自动检测机制防止多个服务器实例冲突
🤝 多AI支持: 多个AI助手可以安全地共享同一个服务器实例

快速开始

克隆仓库

# 克隆仓库
git clone https://github.com/eragonht1/simple-memory-mcp.git

# 进入项目目录
cd simple-memory-mcp

系统要求

Node.js 16.0.0 或更高版本
最低512MB内存
100MB可用存储空间

Node.js安装指南

Windows用户：

访问 Node.js官方网站
下载LTS（长期支持）版本
运行安装程序（.msi文件）
按照安装向导的默认设置进行安装
安装完成后重启计算机

macOS用户：

# 方法1：从官网下载
# 访问 https://nodejs.org/ 下载LTS版本

# 方法2：使用Homebrew（推荐）
brew install node

Linux用户：

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm

# Arch Linux
sudo pacman -S nodejs npm

验证安装：

# 检查Node.js版本
node --version

# 检查npm版本
npm --version

两个命令都应该返回版本号（例如：Node.js显示v18.17.0）。

安装步骤

# 安装依赖
npm install

# 初始化数据库
npm run init-db

启动服务

# 启动MCP服务器
npm start

# 启动Web管理界面（推荐）
node start-web.js
# 或者
npm run web

访问Web界面

默认地址: http://localhost:8011
系统会自动检测并分配可用端口
使用专业启动器时会自动打开浏览器

AI助手配置

通用配置模板

以下配置模板适用于任何支持MCP的AI助手：

{
  "mcpServers": {
    "simple-memory": {
      "command": "node",
      "args": ["/path/to/your/simple-memory-mcp/start-mcp.js"],
      "cwd": "/path/to/your/simple-memory-mcp"
    }
  }
}

配置步骤：

将 /path/to/your/simple-memory-mcp 替换为你的实际项目路径
将此配置添加到你的AI助手的MCP设置文件中
重启你的AI助手以加载新配置

注意： start-mcp.js 脚本相比直接调用 src/server.js 提供了更好的错误处理和用户友好的输出信息。

🔒 单实例设计

Simple Memory MCP 采用单实例设计，确保最佳的资源使用和数据一致性：

自动检测: 启动前系统会检查是否已有MCP服务器在运行
智能共享: 多个AI助手（Claude、Augment等）可以安全地共享同一个服务器实例
资源高效: 防止重复的服务器进程和数据库冲突
无缝体验: 如果服务器已在运行，新的AI连接会自动使用现有实例

多AI工作流程：

第一个AI启动 → 检测无服务器 → 启动新MCP服务器 → 成功连接
第二个AI启动 → 检测到现有服务器 → 显示友好提示 → 连接到现有实例
两个AI可以同时使用记忆功能 而不会产生冲突
当所有AI关闭时 → MCP服务器自动关闭以释放资源

使用示例

通过AI助手使用

用户: 帮我存储一个记忆
AI: 请提供这个记忆的标题：
用户: 学习笔记 - MCP协议
AI: 请输入记忆的具体内容：
用户: [输入内容]
AI: 记忆 "学习笔记 - MCP协议" 已成功存储！

新功能！Web界面自动启动

只需对AI助手说出以下任一触发词：

"打开记忆MCP"
"打开记忆"
"打开记忆WEB"
"开启记忆"

AI将自动：

🚀 启动Web服务器（如果未运行）
🌐 打开默认浏览器
📋 显示记忆管理界面
✨ 提供使用提示和访问地址

通过Web界面使用

点击"➕ 添加记忆"创建新记忆
点击记忆卡片查看详情
使用每个记忆卡片上的操作按钮：
- 编辑 (🖊️) - 修改记忆内容
- 复制 (📋) - 将标题和内容以纯文本格式复制到剪贴板
- 删除 (🗑️) - 永久删除记忆
使用搜索框查找特定内容
拖拽记忆卡片可以重新排序

MCP工具

store_memory - 存储新记忆（需要标题和内容参数）
list_memory_titles - 获取所有记忆标题列表
get_memory_by_title - 根据标题检索记忆内容
delete_memory - 删除指定记忆
open_memory_web - 新功能！ 打开记忆管理Web界面并自动启动浏览器

文档

详细文档请参见 DOCS.md，包含：

完整API文档
部署指南
开发文档
端口管理系统
用户指南

故障排除

端口冲突:

# Windows
netstat -ano | findstr :8011
taskkill /PID <PID> /F

# Linux/macOS
lsof -i :8011
kill -9 <PID>

数据库问题:

rm data/memories.db
npm run init-db

Web界面自动启动问题:

# 如果浏览器没有自动打开
# 检查Web服务器是否运行
curl http://localhost:8011

# 手动打开AI响应中显示的URL
# 例如: http://localhost:8011

# 检查浏览器可用性 (Linux)
which xdg-open firefox google-chrome

# 检查浏览器可用性 (Windows)
where start

# 检查浏览器可用性 (macOS)
which open

License / 许可证

MIT License

Simple Memory MCP - 让AI助手拥有持久记忆的能力 💾✨ Simple Memory MCP - Giving AI assistants persistent memory capabilities 💾✨