mcp-память-libsql

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

Функции

🚀 Высокопроизводительный векторный поиск с использованием libSQL
💾 Постоянное хранение сущностей и отношений
🔍 Возможности семантического поиска
🔄 Управление графом знаний
🌐 Совместимость с локальными и удаленными базами данных libSQL
🔒 Безопасная аутентификация на основе токенов для удаленных баз данных

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

Этот сервер предназначен для использования в качестве части конфигурации 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 публикацию необходимо выполнять вручную:

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

pnpm changeset

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

pnpm changeset version

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

pnpm release

Внося вклад

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

Лицензия

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

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

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

mcp-memory-libsql

Integrations