local-memory-mcp 1.0.2

package/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+All notable changes to the @local-memory/server npm package will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2025-08-26
+
+### Added
+- Initial release of @local-memory/server npm package
+- Cross-platform binary distribution for macOS (Intel/ARM), Linux, and Windows
+- Automatic platform detection and binary download
+- Integration with existing S3 distribution infrastructure
+- Fallback to GitHub Releases for download reliability
+- Comprehensive installation, testing, and uninstall scripts
+- MCP (Model Context Protocol) server integration
+- 20+ MCP tools for memory management and AI analysis
+- License validation integration with existing license system
+- Global binary installation support (`local-memory` command)
+- Complete documentation and troubleshooting guides
+
+### Features
+- **Platform Support**: Automatic detection and installation for all supported platforms
+- **Download Strategy**: Multi-tier download with S3 primary and GitHub fallback
+- **Binary Management**: Automatic permissions setting and validation
+- **License Integration**: Seamless integration with localmemory.co license system
+- **MCP Compatibility**: Full MCP server implementation with stdio protocol
+- **CLI Interface**: Complete command-line interface matching standalone binary
+- **Error Handling**: Comprehensive error messages and troubleshooting guidance
+- **Testing Suite**: Built-in test scripts for installation validation
+
+### Technical Details
+- Node.js 16+ compatibility
+- Cross-platform binary execution wrapper
+- Secure download with integrity verification
+- Automatic executable permissions management
+- Integration with existing GitHub Actions CI/CD pipeline
+- Support for both global and local npm installations
+
+### Documentation
+- Complete README with installation and usage instructions
+- Troubleshooting guide for common issues
+- MCP integration examples
+- Platform-specific guidance
+- Support and contact information

package/README.md

@@ -0,0 +1,256 @@
+# local-memory-mcp
+
+Local Memory MCP Server - AI-powered persistent memory system for Claude Desktop and other MCP-compatible tools.
+
+[![npm version](https://img.shields.io/npm/v/local-memory-mcp.svg)](https://www.npmjs.com/package/local-memory-mcp)
+[![License](https://img.shields.io/badge/license-Commercial-blue.svg)](https://localmemory.co/terms)
+[![Platform Support](https://img.shields.io/badge/platforms-macOS%20%7C%20Linux%20%7C%20Windows-green.svg)](#platform-support)
+
+## What is Local Memory?
+
+Local Memory is a revolutionary AI memory system that gives Claude Desktop and other AI tools **persistent, searchable memory**. Unlike traditional AI that forgets everything between conversations, Local Memory creates a growing knowledge base that makes your AI smarter over time.
+
+### Key Features
+
+- 🧠 **Persistent Memory**: Your AI remembers every conversation, decision, and solution
+- 🔍 **Semantic Search**: AI-powered search that understands context and meaning  
+- 🎯 **Vector Database**: High-performance search with Qdrant integration + SQLite fallback
+- 🤖 **20+ MCP Tools**: Complete toolkit for memory management and AI analysis
+- 🔐 **100% Local**: Your data never leaves your machine - complete privacy
+- ⚡ **Production Ready**: Handles 34,466+ memories per second
+
+## Quick Start
+
+### 1. Install
+
+```bash
+npm install -g local-memory-mcp
+```
+
+### 2. Get Your License
+
+Visit [localmemory.co](https://localmemory.co) to purchase your license key.
+
+### 3. Activate License
+
+```bash
+local-memory license activate LM-XXXX-XXXX-XXXX-XXXX-XXXX
+```
+
+### 4. Start Local Memory
+
+```bash
+local-memory start
+```
+
+### 5. Install for Claude Desktop
+
+```bash
+local-memory install mcp
+```
+
+That's it! Your AI now has persistent memory.
+
+## Platform Support
+
+| Platform | Architecture | Status |
+|----------|-------------|--------|
+| macOS | Intel (x64) | ✅ Fully Supported |
+| macOS | Apple Silicon (ARM64) | ✅ Fully Supported |
+| Linux | x64 | ✅ Fully Supported |
+| Windows | x64 | ✅ Fully Supported |
+
+## MCP Integration
+
+Local Memory implements the Model Context Protocol (MCP) and integrates seamlessly with:
+
+- **Claude Desktop** - Anthropic's official desktop app
+- **Cline** - VS Code AI coding assistant  
+- **Any MCP-compatible tool**
+
+### MCP Configuration
+
+After running `local-memory install mcp`, your Claude Desktop config will include:
+
+```json
+{
+  "mcpServers": {
+    "local-memory": {
+      "command": "local-memory",
+      "args": ["--mcp"]
+    }
+  }
+}
+```
+
+## Available Commands
+
+### Memory Operations
+```bash
+local-memory remember "Important information to store"
+local-memory search "what was that about databases?"
+local-memory forget <memory-id>
+```
+
+### System Management
+```bash
+local-memory start           # Start the daemon
+local-memory stop            # Stop the daemon  
+local-memory status          # Check daemon status
+local-memory doctor          # Run diagnostics
+```
+
+### License Management
+```bash
+local-memory license activate LM-XXXX-XXXX-XXXX-XXXX-XXXX
+local-memory license status
+local-memory license validate <key>
+```
+
+### Setup & Installation
+```bash
+local-memory setup           # Interactive setup wizard
+local-memory install mcp     # Install for Claude Desktop
+```
+
+## MCP Tools (20+ Available)
+
+When connected via MCP, Local Memory provides these tools to your AI:
+
+### Core Memory
+- `store_memory` - Store information with importance scoring
+- `search_memories` - Semantic search across all memories
+- `update_memory` - Modify existing memories
+- `delete_memory` - Remove memories
+- `get_memory_by_id` - Retrieve specific memories
+
+### Advanced Search
+- `search_by_tags` - Find memories by category
+- `search_by_date_range` - Temporal memory queries
+- `get_related_memories` - Find connected information
+
+### AI Analysis
+- `ask_question` - Natural language Q&A about your memories
+- `summarize_memories` - Generate summaries of complex topics
+- `analyze_memories` - Discover patterns and insights
+
+### Relationship Management
+- `create_relationship` - Link related memories
+- `discover_relationships` - Find memory connections
+- `map_memory_graph` - Visualize knowledge connections
+
+### Organization
+- `categorize_memory` - AI-powered automatic categorization
+- `list_categories` - Browse your knowledge structure
+- `create_domain` - Separate knowledge spaces
+
+### Session Intelligence
+- `list_sessions` - Track learning sessions
+- `get_session_stats` - Session analytics
+
+## Dependencies
+
+### Required
+- **Node.js** 16+ (for npm installation only - not needed at runtime)
+
+### Optional (Enhanced Features)
+- **Ollama** - For AI-powered semantic search and categorization
+  ```bash
+  # Install Ollama
+  curl -fsSL https://ollama.ai/install.sh | sh
+  
+  # Pull required models
+  ollama pull nomic-embed-text    # For embeddings (required for AI features)
+  ollama pull qwen2.5:7b         # For chat completions (recommended)
+  ```
+
+- **Qdrant** - For high-performance vector search (10-50x faster than SQLite)
+  ```bash
+  # macOS
+  brew install qdrant
+  
+  # Linux
+  snap install qdrant
+  
+  # Docker
+  docker run -p 6333:6333 qdrant/qdrant
+  ```
+
+## Architecture
+
+Local Memory uses a sophisticated multi-layer architecture:
+
+- **MCP Protocol Layer**: JSON-RPC over stdio for AI integration
+- **Storage Layer**: SQLite with custom migrations + optional Qdrant vector DB
+- **Services Layer**: Memory, Vector, Analysis, Ollama, and Qdrant services
+- **API Layer**: REST endpoints for web integration
+
+## Data Storage
+
+All data is stored locally in `~/.local-memory/`:
+
+- `config.json` - Configuration settings
+- `unified-memories.db` - SQLite database with your memories
+- `license.json` - License information
+
+**Your data never leaves your machine.**
+
+## Troubleshooting
+
+### Installation Issues
+
+**Binary not found or permission denied:**
+```bash
+# macOS/Linux: Fix permissions
+chmod +x ~/.npm-global/lib/node_modules/local-memory-mcp/bin/*
+
+# macOS: Allow in Security & Privacy, or:
+xattr -rd com.apple.quarantine ~/.npm-global/lib/node_modules/local-memory-mcp/bin/*
+```
+
+**Download fails:**
+- Check your internet connection
+- Try again in a few minutes (server issue)
+- Download manually from [localmemory.co](https://localmemory.co)
+
+### Runtime Issues
+
+**License activation fails:**
+```bash
+local-memory doctor          # Run diagnostics
+local-memory license status  # Check current license
+```
+
+**Claude Desktop not connecting:**
+```bash
+local-memory install mcp     # Reinstall MCP configuration
+local-memory status          # Verify daemon is running
+```
+
+**Memory search not working:**
+- Install Ollama for semantic search
+- Check Qdrant installation for performance
+- SQLite fallback always available
+
+## Support
+
+- 📖 **Documentation**: [localmemory.co/docs](https://localmemory.co/docs)
+- 💬 **Support**: [localmemory.co/support](https://localmemory.co/support)
+- 🐛 **Issues**: [GitHub Issues](https://github.com/danieleugenewilliams/local-memory-golang/issues)
+- 💼 **Enterprise**: [contact@localmemory.co](mailto:contact@localmemory.co)
+
+## License
+
+Local Memory is commercial software. A license key is required for use.
+
+- **Individual License**: Available at [localmemory.co](https://localmemory.co)
+- **Enterprise License**: Contact [contact@localmemory.co](mailto:contact@localmemory.co)
+- **Terms**: [localmemory.co/terms](https://localmemory.co/terms)
+
+## Contributing
+
+Local Memory is closed-source commercial software. For feature requests or bug reports, please use [GitHub Issues](https://github.com/danieleugenewilliams/local-memory-golang/issues).
+
+---
+
+**Transform your AI from goldfish to genius. Get started at [localmemory.co](https://localmemory.co)**

package/bin/local-memory

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+
+/**
+ * Local Memory Binary Launcher
+ * 
+ * This script launches the appropriate Local Memory binary for the current platform.
+ * It serves as the global binary when the package is installed with -g flag.
+ */
+
+const path = require('path');
+
+// Import and run the main function from index.js
+const { main } = require(path.join(__dirname, '..', 'index.js'));
+
+main();

package/index.js

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+
+/**
+ * @local-memory/server
+ * 
+ * Local Memory MCP Server - AI-powered persistent memory system
+ * 
+ * This is the main entry point for the @local-memory/server npm package.
+ * It provides a unified interface to the Local Memory binary across platforms.
+ * 
+ * @author Local Memory <contact@localmemory.co>
+ * @license SEE LICENSE IN https://localmemory.co/terms
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+
+/**
+ * Get the platform-specific binary name
+ */
+function getBinaryName() {
+  const platform = os.platform();
+  const arch = os.arch();
+  
+  switch (platform) {
+    case 'darwin':
+      return arch === 'arm64' ? 'local-memory-macos-arm' : 'local-memory-macos-intel';
+    case 'linux':
+      return 'local-memory-linux';
+    case 'win32':
+      return 'local-memory-windows.exe';
+    default:
+      throw new Error(`Unsupported platform: ${platform}-${arch}`);
+  }
+}
+
+/**
+ * Get the path to the local-memory binary
+ */
+function getBinaryPath() {
+  const binaryName = getBinaryName();
+  const binaryPath = path.join(__dirname, 'bin', binaryName);
+  
+  if (!fs.existsSync(binaryPath)) {
+    console.error(`Error: Local Memory binary not found at ${binaryPath}`);
+    console.error('');
+    console.error('This may indicate an installation issue. Please try:');
+    console.error('1. Reinstall the package: npm uninstall @local-memory/server && npm install @local-memory/server');
+    console.error('2. Check your platform support at: https://localmemory.co/docs/installation');
+    console.error('3. If issues persist, contact support: https://localmemory.co/support');
+    process.exit(1);
+  }
+  
+  return binaryPath;
+}
+
+/**
+ * Main execution function
+ */
+function main() {
+  try {
+    const binaryPath = getBinaryPath();
+    const args = process.argv.slice(2);
+    
+    // Execute the local-memory binary with all arguments
+    const child = spawn(binaryPath, args, {
+      stdio: 'inherit',
+      cwd: process.cwd()
+    });
+    
+    // Handle process termination
+    child.on('exit', (code, signal) => {
+      if (signal) {
+        process.exit(128 + os.constants.signals[signal]);
+      } else {
+        process.exit(code || 0);
+      }
+    });
+    
+    // Handle errors
+    child.on('error', (error) => {
+      if (error.code === 'ENOENT') {
+        console.error('Error: Local Memory binary not found or not executable.');
+        console.error('');
+        console.error('Please ensure the binary has proper permissions:');
+        console.error(`chmod +x "${binaryPath}"`);
+        console.error('');
+        console.error('If you\'re on macOS, you may need to allow the binary in System Preferences > Security & Privacy');
+        console.error('Or run: xattr -rd com.apple.quarantine "${binaryPath}"');
+      } else {
+        console.error(`Error executing Local Memory: ${error.message}`);
+      }
+      process.exit(1);
+    });
+    
+    // Handle termination signals
+    ['SIGINT', 'SIGTERM'].forEach(signal => {
+      process.on(signal, () => {
+        child.kill(signal);
+      });
+    });
+    
+  } catch (error) {
+    console.error(`Error: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+// Only run main if this file is executed directly
+if (require.main === module) {
+  main();
+}
+
+module.exports = {
+  getBinaryPath,
+  getBinaryName,
+  main
+};

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "local-memory-mcp",
+  "version": "1.0.2",
+  "description": "Local Memory MCP Server - AI-powered persistent memory system for Claude Desktop and other MCP-compatible tools",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "ai",
+    "memory",
+    "vector-search",
+    "local-memory",
+    "anthropic",
+    "mcp-server"
+  ],
+  "author": "Local Memory <contact@localmemory.co>",
+  "license": "SEE LICENSE IN https://localmemory.co/terms",
+  "homepage": "https://localmemory.co",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/danieleugenewilliams/local-memory-golang.git"
+  },
+  "bugs": {
+    "url": "https://github.com/danieleugenewilliams/local-memory-golang/issues"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "main": "index.js",
+  "bin": {
+    "local-memory": "bin/local-memory"
+  },
+  "scripts": {
+    "postinstall": "node scripts/install.js",
+    "test": "node scripts/test.js",
+    "test:package": "node test/test-npm-package.js",
+    "test:integration": "node test/test-integration.js",
+    "test:all": "npm run test:package && npm run test:integration",
+    "uninstall": "node scripts/uninstall.js"
+  },
+  "files": [
+    "index.js",
+    "bin/",
+    "scripts/",
+    "test/",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "preferGlobal": true,
+  "publishConfig": {
+    "access": "public"
+  },
+  "mcp": {
+    "server": true,
+    "protocol": "stdio",
+    "description": "AI-powered persistent memory system with vector search and semantic analysis",
+    "capabilities": [
+      "memory_storage",
+      "vector_search",
+      "ai_analysis",
+      "temporal_patterns",
+      "relationship_mapping",
+      "categorization"
+    ]
+  },
+  "funding": {
+    "type": "individual",
+    "url": "https://localmemory.co"
+  }
+}