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 do-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 do-memory-mcp server exposes episodic memory functionality through the Model Context Protocol:
- Query past experiences and learned patterns
- Analyze successful strategies from historical episodes
- Perform advanced statistical and predictive analysis
- Monitor server health and metrics
- Note:
execute_agent_codeis unavailable / fail-closed (WASM sandbox removed; no working execution backend)
Location: ./target/release/do-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 |
Unavailable / fail-closed (WASM sandbox removed) |
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 do-memory-mcp-server
# Run directly
export TURSO_DATABASE_URL="file:./data/memory.db"
./target/release/do-memory-mcp-server
# Run via MCP Inspector for testing
npx -y @modelcontextprotocol/inspector ./target/release/do-memory-mcp-server
See configuration.md for full environment setup and validation.md for MCP Inspector workflow.