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-server
See configuration.md for full environment setup and validation.md for MCP Inspector workflow.