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-메모리-libsql

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

특징

🚀 libSQL을 사용한 고성능 벡터 검색
💾 엔티티 및 관계의 영구 저장
🔍 의미 검색 기능
🔄 지식 그래프 관리
🌐 로컬 및 원격 libSQL 데이터베이스와 호환
🔒 원격 데이터베이스를 위한 보안 토큰 기반 인증

구성

이 서버는 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 요구 사항으로 인해 게시는 수동으로 수행해야 합니다.

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

pnpm changeset

패키지 버전(버전 및 CHANGELOG 업데이트):

pnpm changeset version

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

pnpm release

기여하다

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

특허

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

감사의 말

모델 컨텍스트 프로토콜을 기반으로 구축됨
libSQL 로 구동됨

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

지속적인 메모리와 벡터 검색 기능을 위해 libSQL을 활용하는 고성능 MCP 서버로, 효율적인 엔터티 관리와 의미적 지식 저장을 가능하게 합니다.

Related Resources

Reddit Discussion about this server