mcp-memory-ts
Advanced tools
Cloud-based vector MCP memory service for Claude.ai - TypeScript implementation
A modern TypeScript implementation of a cloud-based vector memory service for AI assistants via the Model Context Protocol (MCP). This service provides persistent storage with semantic search capabilities for Claude.ai and other AI assistants.
src/
├── types/ # TypeScript type definitions
├── models/ # Data models and schemas
├── database/ # Database connection and operations
├── core/ # Core memory logic and vector search
├── mcp/ # MCP server implementation
├── api/ # REST API server
├── cli/ # CLI tool
├── utils/ # Utility functions
└── index.ts # Main entry point
web/
├── app/ # Next.js app directory
├── components/ # React components
├── lib/ # Utilities and integrations
└── public/ # Static assets
# Clone and install dependencies
npm install
# Copy environment configuration
cp .env.local .env
# Build the project
npm run build
# Start development server
npm run dev
Required variables in .env:
# Database Configuration
TURSO_URL=libsql://your-database.turso.io
TURSO_AUTH_TOKEN=your-auth-token
# OpenAI Configuration (for vector embeddings)
OPENAI_API_KEY=your-openai-api-key
# Optional Configuration
LOG_LEVEL=INFO
MCP_DEBUG=0
DEFAULT_USER_EMAIL=user@example.com
# Automatic Embedding Updates (v1.1.0+)
ENABLE_EMBEDDING_MONITOR=true # Enable background monitoring
EMBEDDING_MONITOR_INTERVAL=60000 # Check every 60 seconds
# Web Interface (v1.3.0+)
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your-clerk-publishable-key
CLERK_SECRET_KEY=your-clerk-secret-key
# Google Integration (v1.7.0+)
GOOGLE_CLIENT_ID=your-google-client-id
GOOGLE_CLIENT_SECRET=your-google-client-secret
GOOGLE_REDIRECT_URI=http://localhost:3000/api/auth/google/callback
Recommended: Using CLI Tool
# Install globally
npm install -g mcp-memory-ts
# Initialize configuration
mcp-memory init
# Install to Claude Desktop
mcp-memory install
# Check status
mcp-memory status
This creates a config in ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"mcp-memory-ts": {
"command": "mcp-memory",
"args": ["server"],
"env": {
"TURSO_URL": "your-database-url",
"TURSO_AUTH_TOKEN": "your-auth-token",
"OPENAI_API_KEY": "your-openai-key",
"DEFAULT_USER_EMAIL": "user@example.com"
}
}
}
}
Manual Setup
For development or manual configuration:
# Start MCP server
npm run mcp-server
# Or with debug logging
MCP_DEBUG=1 npm run mcp-server
# Or using CLI command
mcp-memory server --debug
For web applications and remote access with Clerk authentication:
# Start remote MCP server
npm run mcp-server-remote
The remote MCP server will be available at http://localhost:3003 with:
/mcp (main), /healthGet Clerk credentials from dashboard.clerk.com
Configure environment:
# Development Keys
CLERK_SECRET_KEY=your-clerk-test-secret-key
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_bmF0aXZlLW1hcm1vc2V0LTc0LmNsZXJrLmFjY291bnRzLmRldiQ
# Production Keys (when ready)
CLERK_SECRET_KEY=your-clerk-live-secret-key
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_live_Y2xlcmsuYWktbWVtb3J5LmFwcCQ
Start server:
npm run mcp-server-remote
Test with authentication:
curl -X POST http://localhost:3003/mcp \
-H "Authorization: Bearer YOUR_CLERK_TOKEN" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'
See docs/REMOTE_MCP_SETUP.md for detailed setup instructions.
Modern Next.js web interface for visual memory management:
# Setup web interface
./scripts/setup-web.sh
# Start development server
cd web
npm run dev
The web interface will be available at http://localhost:3001 with:
See docs/features/WEB_INTERFACE.md for complete setup and deployment guide.
# Start REST API server
npm run api-server
The API will be available at http://localhost:3000 with endpoints for:
/api/memories - Memory management/api/entities - Entity management/api/search - Vector and text search/api/users - User management# Run tests
npm test
# Run tests with coverage
npm run test:coverage
# Lint code
npm run lint
# Format code
npm run format
# Type checking
npm run type-check
The project includes comprehensive test coverage:
See docs/testing/QA_TEST_REPORT.md for detailed test results.
MIT License - See LICENSE file for details.
A comprehensive test suite is available to verify data integrity and system reliability:
# Run the full test suite
tsx comprehensive-integrity-test.ts
The test suite validates:
Expected results: 17/17 tests passed, 5/5 production criteria met
See docs/testing/ for detailed test results and analysis.
FAQs
Cloud-based vector MCP memory service for Claude.ai - TypeScript implementation
The npm package mcp-memory-ts receives a total of 48 weekly downloads. As such, mcp-memory-ts popularity was classified as not popular.
We found that mcp-memory-ts demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Company News
Socket won two 2026 Reppy Awards from RepVue, ranking in the top 5% of all sales orgs. AE Alexandra Lister shares what it's like to grow a sales career here.
Security News
NIST will stop enriching most CVEs under a new risk-based model, narrowing the NVD's scope as vulnerability submissions continue to surge.
Company News
/Security News
Socket is an initial recipient of OpenAI's Cybersecurity Grant Program, which commits $10M in API credits to defenders securing open source software.