vestige/packages/vestige-mcp-npm/README.md

59 lines
1.6 KiB
Markdown
Raw Normal View History

# @vestige/mcp
Vestige MCP Server - A synthetic hippocampus for AI assistants.
Built on 130 years of cognitive science research, Vestige provides biologically-inspired memory that decays, strengthens, and consolidates like the human mind.
## Installation
```bash
npm install -g @vestige/mcp
```
## Usage with Claude Desktop
Add to your Claude Desktop configuration:
**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"vestige": {
"command": "vestige-mcp",
"args": ["--project", "."]
}
}
}
```
## Features
- **FSRS-6 Algorithm**: State-of-the-art spaced repetition for optimal memory retention
- **Dual-Strength Memory**: Bjork & Bjork (1992) - Storage + Retrieval strength model
- **Sleep Consolidation**: Bio-inspired memory optimization cycles
- **Semantic Search**: Local embeddings for intelligent memory retrieval
- **Local-First**: All data stays on your machine
## MCP Tools
| Tool | Description |
|------|-------------|
| `remember` | Store a new memory with importance scoring |
| `recall` | Retrieve memories by semantic similarity |
| `search` | Full-text search across all memories |
| `consolidate` | Trigger memory consolidation (sleep cycle) |
| `get_context` | Get relevant context for current project |
## Environment Variables
| Variable | Description | Default |
|----------|-------------|---------|
| `VESTIGE_DATA_DIR` | Data storage directory | `~/.vestige` |
| `VESTIGE_LOG_LEVEL` | Log verbosity | `info` |
## License
MIT