mcp-memory-libsql

by spences10
Verified

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-memory-libsql

libSQLを搭載した、モデルコンテキストプロトコル(MCP)用の高性能永続メモリシステムです。このサーバーは、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" } } } }

WSL 構成の Claude デスクトップ

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ファイルを参照してください。

謝辞

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

永続メモリとベクトル検索機能に libSQL を活用し、効率的なエンティティ管理とセマンティック知識の保存を可能にする高性能 MCP サーバーです。

  1. Features
    1. Configuration
      1. Cline Configuration
      2. Claude Desktop with WSL Configuration
      3. Database Configuration
    2. API
      1. Architecture
        1. Development
          1. Publishing
        2. Contributing
          1. License
            1. Acknowledgments
              ID: 22lg4lq768