Skip to main content
Glama

mcp-메모리-libsql

libSQL 기반의 모델 컨텍스트 프로토콜(MCP)을 위한 고성능 영구 메모리 시스템입니다. 이 서버는 libSQL을 백업 저장소로 사용하여 벡터 검색 기능과 효율적인 지식 저장 기능을 제공합니다.

특징

  • 🚀 libSQL을 사용한 고성능 벡터 검색

  • 💾 엔티티 및 관계의 영구 저장

  • 🔍 의미 검색 기능

  • 🔄 지식 그래프 관리

  • 🌐 로컬 및 원격 libSQL 데이터베이스와 호환

  • 🔒 원격 데이터베이스를 위한 보안 토큰 기반 인증

Related MCP server: MCP Memory LibSQL Go

구성

이 서버는 MCP 구성의 일부로 사용하도록 설계되었습니다. 다음은 다양한 환경에 대한 예시입니다.

클라인 구성

Cline MCP 설정에 다음을 추가하세요.

지엑스피1

WSL 구성을 사용한 Claude Desktop

WSL에서 Claude Desktop을 사용하여 이 서버를 설정하는 방법에 대한 자세한 가이드는 WSL에서 Claude Desktop을 사용하여 MCP 서버 작동시키기를 참조하세요.

WSL 환경에 대한 Claude Desktop 구성에 다음을 추가하세요.

{
	"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"
			]
		}
	}
}

데이터베이스 구성

서버는 LIBSQL_URL 환경 변수를 통해 로컬 SQLite와 원격 libSQL 데이터베이스를 모두 지원합니다.

로컬 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을 사용할 때 데이터베이스 경로가 Windows 형식이 아닌 Linux 파일 시스템 형식(예: /home/username/... )을 사용하는지 확인하세요.

기본적으로 URL이 제공되지 않으면 현재 디렉토리의 file:/memory-tool.db 사용합니다.

API

서버는 추가적인 벡터 검색 기능을 갖춘 표준 MCP 메모리 인터페이스를 구현합니다.

  • 엔티티 관리

    • 임베딩을 사용하여 엔터티 생성/업데이트

    • 엔터티 삭제

    • 유사성으로 엔터티 검색

  • 관계 관리

    • 엔터티 간 관계 생성

    • 관계 삭제

    • 관련 엔터티 쿼리

건축학

서버는 다음 스키마를 가진 libSQL 데이터베이스를 사용합니다.

  • 엔터티 테이블: 엔터티 정보 및 임베딩을 저장합니다.

  • 관계 테이블: 엔터티 간의 관계를 저장합니다.

  • libSQL의 내장 벡터 연산을 사용하여 구현된 벡터 검색 기능

개발

출판

npm 2FA 요구 사항으로 인해 게시는 수동으로 수행해야 합니다.

  1. 변경 세트를 만듭니다(변경 사항을 문서화합니다):

pnpm changeset
  1. 패키지 버전(버전 및 CHANGELOG 업데이트):

pnpm changeset version
  1. npm에 게시합니다(2FA 코드를 입력하라는 메시지가 표시됨):

pnpm release

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출하기 전에 기여 지침을 꼭 읽어주세요.

특허

MIT 라이센스 - 자세한 내용은 LICENSE 파일을 참조하세요.

감사의 말

Available Tools

6 tools
create_entitiesC

Create new entities with observations and optional embeddings

Inputs: entities (required).

create_relationsC

Create relations between entities

Inputs: relations (required).

delete_entityA

Delete an entity and all its associated data (observations and relations)

Inputs: name (required).

delete_relationC

Delete a specific relation between entities

Inputs: source (required), target (required), type (required).

read_graphC

Get recent entities and their relations

Inputs: includeEmbeddings.

search_nodesC

Search for entities and their relations using text or vector similarity

Inputs: query (required), includeEmbeddings.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: create_entities and create_relations handle creation of different object types, delete_entity and delete_relation handle deletion of different object types, read_graph retrieves recent data, and search_nodes performs searches. No ambiguity exists between these operations.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with snake_case naming: create_entities, create_relations, delete_entity, delete_relation, read_graph, and search_nodes. The naming is perfectly predictable and uniform throughout the set.

    Tool Count5/5

    With 6 tools, this server is well-scoped for a memory/graph database system. Each tool earns its place by covering essential CRUD operations (create, delete, read/search) for both entities and relations, without being overly complex or insufficient.

    Completeness4/5

    The tool set provides strong coverage for core graph operations: creation and deletion of entities/relations, reading recent data, and searching. A minor gap exists in update operations (e.g., update_entity or update_relation), but agents can work around this by deleting and recreating as needed.

    Related MCP Connectors

    Related MCP Servers