# Vector Memory MCP Server
> Semantic memory storage for AI assistants. Store decisions, patterns, and context that persists across sessions.
A local-first MCP server that provides vector-based memory storage. Uses local embeddings and LanceDB for fast, private semantic search.
[](https://opensource.org/licenses/MIT)
[](https://www.npmjs.com/package/@aeriondyseti/vector-memory-mcp)
---
## Features
- **Local & Private** - All embeddings generated locally, data stored in local LanceDB
- **Semantic Search** - Vector similarity search with configurable scoring
- **Batch Operations** - Store, update, delete, and retrieve multiple memories at once
- **Session Handoffs** - Save and restore project context between sessions
- **MCP Native** - Standard protocol, works with any MCP-compatible client
---
## Quick Start
### Prerequisites
- [Bun](https://bun.sh/) 1.0+
- An MCP-compatible client (Claude Code, Claude Desktop, etc.)
### Install
```bash
bun install -g @aeriondyseti/vector-memory-mcp
```
> First install downloads ML models (~90MB). This may take a minute.
### Configure
Add to your MCP client config (e.g., `~/.claude/settings.json`):
```json
{
"mcpServers": {
"vector-memory": {
"type": "stdio",
"command": "bunx",
"args": ["--bun", "@aeriondyseti/vector-memory-mcp"]
}
}
}
```
### Use
Restart your MCP client. You now have access to:
| Tool | Description |
|------|-------------|
| `store_memories` | Save memories (accepts array) |
| `search_memories` | Find relevant memories semantically |
| `get_memories` | Retrieve memories by ID (accepts array) |
| `update_memories` | Update existing memories |
| `delete_memories` | Remove memories (accepts array) |
| `store_handoff` | Save session context for later |
| `get_handoff` | Restore session context |
---
## Usage
**Store a memory:**
```
You: "Remember that we use Drizzle ORM for database access"
Assistant: [calls store_memories]
```
**Search memories:**
```
You: "What did we decide about the database?"
Assistant: [calls search_memories with relevant query]
```
**Session handoffs:**
```
You: "Save context for next session"
Assistant: [calls store_handoff with summary, completed items, next steps]
```
---
## Configuration
Environment variables:
| Variable | Default | Description |
|----------|---------|-------------|
| `VECTOR_MEMORY_DB_PATH` | `.vector-memory/memories.db` | Database location |
| `VECTOR_MEMORY_MODEL` | `Xenova/all-MiniLM-L6-v2` | Embedding model |
| `VECTOR_MEMORY_HTTP_PORT` | `3271` | HTTP server port |
---
## Development
```bash
git clone https://github.com/AerionDyseti/vector-memory-mcp.git
cd vector-memory-mcp
bun install
bun run test # Run all tests
bun run dev # Watch mode
bun run typecheck # Type checking
```
See [CHANGELOG.md](CHANGELOG.md) for release history and [ROADMAP.md](ROADMAP.md) for planned features.
---
## Contributing
Contributions welcome! See [issues](https://github.com/AerionDyseti/vector-memory-mcp/issues) for areas we'd love help with.
## License
MIT - see [LICENSE](LICENSE)
---
Built with [MCP SDK](https://github.com/modelcontextprotocol/typescript-sdk), [LanceDB](https://lancedb.com/), and [Transformers.js](https://huggingface.co/docs/transformers.js)
