Memory MCP Server
Interacts with and troubleshoot the Memory Model Context Protocol (MCP) server for the self-learning memory system.
Quick Reference
- Tools - Complete MCP tools reference (query_memory, analyze_patterns, etc.)
- Configuration -.mcp.json structure and environment variables
- Validation - MCP Inspector validation workflow
- Troubleshooting - Common issues and solutions
- Best Practices - Tool usage, configuration, and testing guidelines
- Token Optimization - Reduce token usage by 80-85%
When to Use
- Starting or configuring the memory-mcp server
- Using MCP tools for memory retrieval and pattern analysis
- Validating the MCP server implementation
- Debugging MCP server issues
- Testing MCP tools using the MCP inspector
- Understanding MCP configuration and environment variables
MCP Server Overview
The memory-mcp server exposes episodic memory functionality through the Model Context Protocol:
- Query past experiences and learned patterns
- Analyze successful strategies from historical episodes
- Execute code in a secure sandbox environment
- Perform advanced statistical and predictive analysis
- Monitor server health and metrics
Location: ./target/release/memory-mcp-server Configuration: .mcp.json Transport: stdio (Standard Input/Output)
Available MCP Tools
| Tool | Purpose |
|---|---|
query_memory | Query episodic memory for relevant past experiences |
analyze_patterns | Analyze patterns from past episodes |
advanced_pattern_analysis | Statistical analysis, predictive modeling |
execute_agent_code | Execute TypeScript/JavaScript in sandbox |
health_check | Check server health status |
get_metrics | Get comprehensive monitoring metrics |
See tools.md for detailed tool documentation and best-practices.md for usage guidelines.
Starting the Server
# Build
cargo build --release --bin memory-mcp-server
# Run directly
export TURSO_DATABASE_URL="file:./data/memory.db"
./target/release/memory-mcp-server
# Run via MCP Inspector for testing
npx -y @modelcontextprotocol/inspector ./target/release/memory-mcp-serverSee configuration.md for full environment setup and validation.md for MCP Inspector workflow.