Back to list
d-o-hub

memory-mcp

by d-o-hub

A modular Rust-based self-learning episodic memory system for AI agents, featuring hybrid storage with Turso (SQL) and redb (KV), async execution tracking, reward scoring, reflection, and pattern-based skill evolution. Designed for real-world applicability, maintainability, and scalable agent workflows.

3🍴 0📅 Jan 23, 2026

SKILL.md


name: memory-mcp description: Use and troubleshoot the Memory MCP server for episodic memory retrieval and pattern analysis. Use when working with MCP server tools, validating the MCP implementation, or debugging MCP server issues.

Memory MCP Server

Interact 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

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

ToolPurpose
query_memoryQuery episodic memory for relevant past experiences
analyze_patternsAnalyze patterns from past episodes
advanced_pattern_analysisStatistical analysis, predictive modeling
execute_agent_codeExecute TypeScript/JavaScript in sandbox
health_checkCheck server health status
get_metricsGet 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.

Score

Total Score

75/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

+10
説明文

100文字以上の説明がある

+10
人気

GitHub Stars 100以上

0/15
最近の活動

1ヶ月以内に更新

+10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

+5

Reviews

💬

Reviews coming soon