Skip to content
Back to search

mcp-memory-libsql

🧠 High-performance persistent memory system for Model Context Protocol (MCP) powered by libSQL. Features vector search, semantic knowledge storage, and efficient relationship management - perfect for AI agents and knowledge graph applications.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/spences10/mcp-memory-libsql with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/spences10/mcp-memory-libsql'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/spences10--mcp-memory-libsql/badge.svg)](/listings/spences10--mcp-memory-libsql)

HTML

<a href="/listings/spences10--mcp-memory-libsql"><img src="/api/listings/spences10--mcp-memory-libsql/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md Β· README Β· 161 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # mcp-memory-libsql
  2. A high-performance, persistent memory system for the Model Context
  3. Protocol (MCP) powered by libSQL with optimized text search for LLM
  4. context efficiency.
  5. <a href="https://glama.ai/mcp/servers/22lg4lq768">
  6. <img width="380" height="200" src="https://glama.ai/mcp/servers/22lg4lq768/badge" alt="Glama badge" />
  7. </a>
  8. ## Features
  9. - πŸš€ High-performance text search with relevance ranking
  10. - πŸ’Ύ Persistent storage of entities and relations
  11. - πŸ” Flexible text search with fuzzy matching
  12. - 🎯 Context-optimized for LLM efficiency
  13. - πŸ”„ Knowledge graph management
  14. - 🌐 Compatible with local and remote libSQL databases
  15. - πŸ”’ Secure token-based authentication for remote databases
  16. ## Configuration
  17. This server is designed to be used as part of an MCP configuration.
  18. Here are examples for different environments:
  19. ### Cline Configuration
  20. Add this to your Cline MCP settings:
  21. ```json
  22. {
  23. "mcpServers": {
  24. "mcp-memory-libsql": {
  25. "command": "npx",
  26. "args": ["-y", "mcp-memory-libsql"],
  27. "env": {
  28. "LIBSQL_URL": "file:/path/to/your/database.db"
  29. }
  30. }
  31. }
  32. }
  33. ```
  34. ### Claude Desktop with WSL Configuration
  35. For a detailed guide on setting up this server with Claude Desktop in
  36. WSL, see
  37. [Getting MCP Server Working with Claude Desktop in WSL](https://scottspence.com/posts/getting-mcp-server-working-with-claude-desktop-in-wsl).
  38. Add this to your Claude Desktop configuration for WSL environments:
  39. ```json
  40. {
  41. "mcpServers": {
  42. "mcp-memory-libsql": {
  43. "command": "wsl.exe",
  44. "args": [
  45. "bash",
  46. "-c",
  47. "source ~/.nvm/nvm.sh && LIBSQL_URL=file:/path/to/database.db /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-memory-libsql"
  48. ]
  49. }
  50. }
  51. }
  52. ```
  53. ### Database Configuration
  54. The server supports both local SQLite and remote libSQL databases
  55. through the LIBSQL_URL environment variable:
  56. For local SQLite databases:
  57. ```json
  58. {
  59. "env": {
  60. "LIBSQL_URL": "file:/path/to/database.db"
  61. }
  62. }
  63. ```
  64. For remote libSQL databases (e.g., Turso):
  65. ```json
  66. {
  67. "env": {
  68. "LIBSQL_URL": "libsql://your-database.turso.io",
  69. "LIBSQL_AUTH_TOKEN": "your-auth-token"
  70. }
  71. }
  72. ```
  73. Note: When using WSL, ensure the database path uses the Linux
  74. filesystem format (e.g., `/home/username/...`) rather than Windows
  75. format.
  76. By default, if no URL is provided, it will use `file:/memory-tool.db`
  77. in the current directory.
  78. ## API
  79. The server implements the standard MCP memory interface with optimized
  80. text search:
  81. - Entity Management
  82. - Create/Update entities with observations
  83. - Delete entities
  84. - Search entities by text with relevance ranking
  85. - Explore entity relationships
  86. - Relation Management
  87. - Create relations between entities
  88. - Delete relations
  89. - Query related entities
  90. ## Architecture
  91. The server uses a libSQL database with the following schema:
  92. - Entities table: Stores entity information with timestamps
  93. - Observations table: Stores entity observations
  94. - Relations table: Stores relationships between entities
  95. - Text search with relevance ranking (name > type > observation)
  96. ## Development
  97. ### Publishing
  98. Due to npm 2FA requirements, publishing needs to be done manually:
  99. 1. Create a changeset (documents your changes):
  100. ```bash
  101. pnpm changeset
  102. ```
  103. 2. Version the package (updates version and CHANGELOG):
  104. ```bash
  105. pnpm changeset version
  106. ```
  107. 3. Publish to npm (will prompt for 2FA code):
  108. ```bash
  109. pnpm release
  110. ```
  111. ## Contributing
  112. Contributions are welcome! Please read our contributing guidelines
  113. before submitting pull requests.
  114. ## License
  115. MIT License - see the [LICENSE](LICENSE) file for details.
  116. ## Acknowledgments
  117. - Built on the
  118. [Model Context Protocol](https://github.com/modelcontextprotocol)
  119. - Powered by [libSQL](https://github.com/tursodatabase/libsql)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.