mcp-memory-libsql

by spences10
Verified

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Uses SQLite as a local database option for persistent storage of entities, relations and vector embeddings

  • Supports Turso as a remote libSQL database option for persistent storage of entities, relations and vector embeddings

mcp-memoria-libsql

Un sistema de memoria persistente de alto rendimiento para el Protocolo de Contexto de Modelo (MCP) basado en libSQL. Este servidor proporciona funciones de búsqueda vectorial y un almacenamiento eficiente de conocimiento utilizando libSQL como almacén de respaldo.

Características

  • Búsqueda vectorial de alto rendimiento con libSQL
  • 💾 Almacenamiento persistente de entidades y relaciones
  • 🔍 Capacidades de búsqueda semántica
  • 🔄 Gestión de gráficos de conocimiento
  • 🌐 Compatible con bases de datos libSQL locales y remotas
  • 🔒 Autenticación segura basada en tokens para bases de datos remotas

Configuración

Este servidor está diseñado para usarse como parte de una configuración MCP. A continuación, se muestran ejemplos para diferentes entornos:

Configuración de Cline

Agregue esto a su configuración de Cline MCP:

{ "mcpServers": { "mcp-memory-libsql": { "command": "npx", "args": ["-y", "mcp-memory-libsql"], "env": { "LIBSQL_URL": "file:/path/to/your/database.db" } } } }

Escritorio Claude con configuración WSL

Para obtener una guía detallada sobre cómo configurar este servidor con Claude Desktop en WSL, consulte Cómo hacer que el servidor MCP funcione con Claude Desktop en WSL .

Agregue esto a su configuración de Claude Desktop para entornos WSL:

{ "mcpServers": { "mcp-memory-libsql": { "command": "wsl.exe", "args": [ "bash", "-c", "source ~/.nvm/nvm.sh && LIBSQL_URL=file:/path/to/database.db /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-memory-libsql" ] } } }

Configuración de la base de datos

El servidor admite bases de datos SQLite locales y libSQL remotas a través de la variable de entorno LIBSQL_URL:

Para bases de datos SQLite locales:

{ "env": { "LIBSQL_URL": "file:/path/to/database.db" } }

Para bases de datos libSQL remotas (por ejemplo, Turso):

{ "env": { "LIBSQL_URL": "libsql://your-database.turso.io", "LIBSQL_AUTH_TOKEN": "your-auth-token" } }

Nota: Al utilizar WSL, asegúrese de que la ruta de la base de datos utilice el formato del sistema de archivos Linux (por ejemplo, /home/username/... ) en lugar del formato de Windows.

De forma predeterminada, si no se proporciona ninguna URL, se utilizará file:/memory-tool.db en el directorio actual.

API

El servidor implementa la interfaz de memoria MCP estándar con capacidades de búsqueda vectorial adicionales:

  • Gestión de entidades
    • Crear/actualizar entidades con incrustaciones
    • Eliminar entidades
    • Buscar entidades por similitud
  • Gestión de relaciones
    • Crear relaciones entre entidades
    • Eliminar relaciones
    • Consultar entidades relacionadas

Arquitectura

El servidor utiliza una base de datos libSQL con el siguiente esquema:

  • Tabla de entidades: almacena información de entidades e incrustaciones
  • Tabla de relaciones: almacena relaciones entre entidades
  • Capacidades de búsqueda vectorial implementadas utilizando las operaciones vectoriales integradas de libSQL

Desarrollo

Publicación

Debido a los requisitos de 2FA de npm, la publicación debe realizarse manualmente:

  1. Crear un conjunto de cambios (documenta tus cambios):
pnpm changeset
  1. Versión del paquete (actualiza la versión y el REGISTRO DE CAMBIOS):
pnpm changeset version
  1. Publicar en npm (se solicitará el código 2FA):
pnpm release

Contribuyendo

¡Agradecemos sus contribuciones! Lea nuestras normas de contribución antes de enviar solicitudes de incorporación de cambios.

Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles.

Expresiones de gratitud

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Un servidor MCP de alto rendimiento que utiliza libSQL para memoria persistente y capacidades de búsqueda vectorial, lo que permite una gestión eficiente de entidades y el almacenamiento de conocimiento semántico.

  1. Features
    1. Configuration
      1. Cline Configuration
      2. Claude Desktop with WSL Configuration
      3. Database Configuration
    2. API
      1. Architecture
        1. Development
          1. Publishing
        2. Contributing
          1. License
            1. Acknowledgments
              ID: 22lg4lq768