feat: 🎉 init from presonal tool

Author: spences10

.env.example

@@ -0,0 +1,6 @@
+# Database Configuration
+# LIBSQL_URL="libsql://your-database-name.turso.io"
+# LIBSQL_AUTH_TOKEN="your-auth-token"
+
+# Local Development (uncomment for local development)
+LIBSQL_URL="file:memory-tool.db"

.gitignore

@@ -0,0 +1,34 @@
+# Dependencies
+node_modules/
+.pnpm-store/
+
+# Build output
+dist/
+build/
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Logs
+*.log
+npm-debug.log*
+pnpm-debug.log*
+
+# Testing
+coverage/
+
+# Database files
+*.db
+*.db-journal
+
+# OS
+.DS_Store
+Thumbs.db

README.md

@@ -0,0 +1,143 @@
+# mcp-memory-libsql
+
+A high-performance, persistent memory system for the Model Context Protocol (MCP) powered by libSQL. This server provides vector search capabilities and efficient knowledge storage using libSQL as the backing store.
+
+## Features
+
+- 🚀 High-performance vector search using libSQL
+- 💾 Persistent storage of entities and relations
+- 🔍 Semantic search capabilities
+- 🔄 Knowledge graph management
+- 🌐 Compatible with local and remote libSQL databases
+- 🔒 Secure token-based authentication for remote databases
+
+## Installation
+
+```bash
+npm install mcp-memory-libsql
+```
+
+Or with pnpm:
+
+```bash
+pnpm add mcp-memory-libsql
+```
+
+## Usage
+
+### Starting the Server
+
+You can start the server using npx:
+
+```bash
+npx mcp-memory-libsql
+```
+
+### Configuration
+
+The server can be configured by passing environment variables when starting the server:
+
+```bash
+# For a local SQLite database:
+LIBSQL_URL=file:/path/to/your/database.db npx mcp-memory-libsql
+
+# For a remote libSQL database (e.g., Turso):
+LIBSQL_URL=libsql://your-database.turso.io LIBSQL_AUTH_TOKEN=your-auth-token npx mcp-memory-libsql
+```
+
+By default, if no URL is provided, it will use `file:/memory-tool.db` in the current directory.
+
+### Claude Desktop Configuration
+
+Add this to your Claude Desktop configuration:
+
+```json
+{
+	"mcpServers": {
+		"memory": {
+			"command": "npx",
+			"args": ["-y", "mcp-memory-libsql"]
+		}
+	}
+}
+```
+
+## Development
+
+### Prerequisites
+
+- Node.js 22.13.0 or higher
+- pnpm (recommended) or npm
+
+### Setup
+
+1. Clone the repository:
+
+```bash
+git clone https://github.com/yourusername/mcp-memory-libsql.git
+cd mcp-memory-libsql
+```
+
+2. Install dependencies:
+
+```bash
+pnpm install
+```
+
+3. Run database migrations:
+
+```bash
+pnpm run migrate
+```
+
+4. Build the project:
+
+```bash
+pnpm run build
+```
+
+### Running Tests
+
+```bash
+pnpm test
+```
+
+### Development Mode
+
+```bash
+pnpm run dev
+```
+
+## API
+
+The server implements the standard MCP memory interface with additional vector search capabilities:
+
+- Entity Management
+  - Create/Update entities with embeddings
+  - Delete entities
+  - Search entities by similarity
+- Relation Management
+  - Create relations between entities
+  - Delete relations
+  - Query related entities
+
+## Architecture
+
+The server uses a libSQL database with the following schema:
+
+- Entities table: Stores entity information and embeddings
+- Relations table: Stores relationships between entities
+- Vector search capabilities implemented using libSQL's built-in vector operations
+
+## Contributing
+
+Contributions are welcome! Please read our contributing guidelines before submitting pull requests.
+
+## License
+
+MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+
+- Built on the [Model Context Protocol](https://github.com/modelcontextprotocol)
+- Powered by [libSQL](https://github.com/tursodatabase/libsql)

package.json

@@ -0,0 +1,35 @@
+{
+  "name": "libsql-memory",
+  "version": "0.0.1",
+  "description": "LibSQL-based persistent memory tool for MCP",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "libsql-memory": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "start": "node dist/index.js",
+    "dev": "node --loader ts-node/esm src/index.ts",
+    "test": "jest",
+    "migrate": "node --loader ts-node/esm src/db/migrations/run.ts",
+    "prepare": "pnpm run build"
+  },
+  "dependencies": {
+    "@libsql/client": "^0.14.0",
+    "@modelcontextprotocol/sdk": "1.1.1",
+    "@types/node": "^22.10.6",
+    "dotenv": "^16.4.7"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.5",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.7.3"
+  },
+  "volta": {
+    "node": "22.13.0"
+  }
+}