spences10/mcp-memory-libsql

LLM (Large Language Model) 컨텍스트 효율성을 위해 최적화된 텍스트 검색 기능을 갖춘, libSQL 기반의 고성능 영구 메모리 시스템인 Model Context Protocol (MCP)용 메모리 시스템입니다.

• 🚀 관련성 순위 지정(relevance ranking)을 포함한 고성능 텍스트 검색
• 💾 엔티티(entities) 및 관계(relations)의 영구 저장
• 🔍 퍼지 매칭(fuzzy matching)을 지원하는 유연한 텍스트 검색
• 🎯 LLM 효율성을 위해 컨텍스트 최적화
• 🔄 지식 그래프(knowledge graph) 관리
• 🌐 로컬 및 원격 libSQL 데이터베이스와 호환
• 🔒 원격 데이터베이스를 위한 보안 토큰 기반 인증

이 서버는 MCP 설정의 일부로 사용되도록 설계되었습니다. 다양한 환경에 대한 예시는 다음과 같습니다:

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

{
"mcpServers": {
"mcp-memory-libsql": {
...

WSL에서 Claude Desktop과 함께 이 서버를 설정하는 방법에 대한 자세한 가이드는 Getting MCP Server Working with Claude Desktop in WSL을 참조하세요.

WSL 환경의 Claude Desktop 설정에 다음을 추가하세요:

{
"mcpServers": {
"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",
...

참고: WSL을 사용할 때는 데이터베이스 경로가 Windows 형식이 아닌 Linux 파일 시스템 형식(예: /home/username/...)을 사용하도록 하세요.

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

이 서버는 최적화된 텍스트 검색 기능을 갖춘 표준 MCP 메모리 인터페이스를 구현합니다:

• 엔티티 관리 (Entity Management)

  • 관찰 사항(observations)과 함께 엔티티 생성/업데이트
  • 엔티티 삭제
  • 관련성 순위 지정(relevance ranking)을 통한 텍스트 기반 엔티티 검색
  • 엔티티 관계 탐색

• 관계 관리 (Relation Management)

  • 엔티티 간의 관계 생성
  • 관계 삭제
  • 관련 엔티티 쿼리

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

• Entities 테이블: 타임스탬프와 함께 엔티티 (Entity) 정보를 저장합니다.
• Observations 테이블: 엔티티 관찰 (Observation) 내용을 저장합니다.
• Relations 테이블: 엔티티 간의 관계 (Relationship)를 저장합니다.
• 관련성 순위 (Relevance ranking)를 적용한 텍스트 검색 (name > type > observation)

npm 2FA (2단계 인증) 요구 사항으로 인해, 배포는 수동으로 진행해야 합니다:

• 변경 사항 세트 (Changeset, 변경 내용을 문서화) 생성:

pnpm changeset

• 패키지 버전 관리 (Version, 버전 및 CHANGELOG 업데이트):

pnpm changeset version

• npm에 배포 (2FA 코드를 요청합니다):

pnpm release

기여를 환영합니다! Pull Request를 제출하기 전에 기여 가이드라인 (Contributing guidelines)을 읽어주세요.

MIT License - 자세한 내용은 LICENSE 파일을 참조하세요.

• Model Context Protocol 기반 구축
• libSQL 기반 구동