Skip to main content
Glama

mcp-memory-libsql

libSQLを搭載した、モデルコンテキストプロトコル(MCP)用の高性能永続メモリシステムです。このサーバーは、libSQLをバックエンドストアとして使用し、ベクトル検索機能と効率的な知識ストレージを提供します。

特徴

  • 🚀 libSQL を使用した高性能ベクトル検索

  • 💾 エンティティとリレーションの永続的な保存

  • 🔍 セマンティック検索機能

  • 🔄 ナレッジグラフ管理

  • 🌐 ローカルおよびリモートの libSQL データベースと互換性があります

  • 🔒 リモートデータベース向けの安全なトークンベースの認証

Related MCP server: MCP Memory LibSQL Go

構成

このサーバーは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ファイルを参照してください。

謝辞

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