mcp-память-libsql

Высокопроизводительная, постоянная система памяти для Model Context Protocol (MCP) на базе libSQL. Этот сервер обеспечивает возможности векторного поиска и эффективное хранение знаний с использованием libSQL в качестве резервного хранилища.

Функции

• 🚀 Высокопроизводительный векторный поиск с использованием libSQL

• 💾 Постоянное хранение сущностей и отношений

• 🔍 Возможности семантического поиска

• 🔄 Управление графом знаний

• 🌐 Совместимость с локальными и удаленными базами данных libSQL

• 🔒 Безопасная аутентификация на основе токенов для удаленных баз данных

Related MCP server: MCP Server for Qdrant

Конфигурация

Этот сервер предназначен для использования в качестве части конфигурации MCP. Вот примеры для различных сред:

Конфигурация Клайна

Добавьте это в настройки Cline MCP:

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

Claude Desktop с конфигурацией WSL

Подробное руководство по настройке этого сервера с Claude Desktop в WSL см. в разделе «Настройка работы сервера MCP с Claude Desktop в WSL» .

Добавьте это в конфигурацию Claude Desktop для сред 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"
			]
		}
	}
}

Конфигурация базы данных

Сервер поддерживает как локальные базы данных SQLite, так и удаленные базы данных libSQL через переменную среды LIBSQL_URL:

Для локальных баз данных SQLite:

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

Для удаленных баз данных libSQL (например, Turso):

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

Примечание: При использовании WSL убедитесь, что путь к базе данных использует формат файловой системы Linux (например, /home/username/... ), а не формат Windows.

По умолчанию, если URL-адрес не указан, будет использоваться file:/memory-tool.db в текущем каталоге.

API

Сервер реализует стандартный интерфейс памяти MCP с дополнительными возможностями векторного поиска:

• Управление сущностями

  • Создание/обновление сущностей с вложениями

  • Удалить сущности

  • Поиск сущностей по сходству

• Управление отношениями

  • Создание отношений между сущностями

  • Удалить отношения

  • Запрос связанных сущностей

Архитектура

Сервер использует базу данных libSQL со следующей схемой:

• Таблица сущностей: хранит информацию о сущностях и внедрениях.

• Таблица отношений: хранит отношения между сущностями.

• Возможности векторного поиска реализованы с использованием встроенных векторных операций libSQL

Разработка

Издательский

Из-за требований npm 2FA публикацию необходимо выполнять вручную:

1. Создайте набор изменений (документируйте ваши изменения):

pnpm changeset

2. Версия пакета (обновляет версию и CHANGELOG):

pnpm changeset version

3. Опубликовать в npm (будет запрошен код 2FA):

pnpm release

Внося вклад

Вклады приветствуются! Пожалуйста, ознакомьтесь с нашими правилами по внесению вкладов перед отправкой запросов на извлечение.

Лицензия

Лицензия MIT — подробности см. в файле LICENSE .

Благодарности

• Построен на основе протокола модельного контекста

• Работает на libSQL