memory-mcp

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Memory MCP Server

Memory MCP 服务器

Interact with and troubleshoot the Memory Model Context Protocol (MCP) server for the self-learning memory system.
与自学习记忆系统的Memory Model Context Protocol(MCP)服务器进行交互并排查问题。

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
  • 工具 - 完整的MCP工具参考文档(包含query_memory、analyze_patterns等)
  • 配置 - .mcp.json结构与环境变量说明
  • 验证 - MCP Inspector验证流程
  • 故障排查 - 常见问题及解决方案
  • 最佳实践 - 工具使用、配置与测试指南

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
  • 启动或配置memory-mcp服务器
  • 使用MCP工具进行记忆检索和模式分析
  • 验证MCP服务器的实现
  • 调试MCP服务器问题
  • 使用MCP Inspector测试MCP工具
  • 了解MCP配置与环境变量

MCP Server Overview

MCP服务器概述

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)
memory-mcp服务器通过Model Context Protocol(MCP)提供情景记忆功能:
  • 查询过往经历与已学习的模式
  • 从历史事件中分析成功策略
  • 在安全沙箱环境中执行代码
  • 执行高级统计与预测分析
  • 监控服务器健康状态与指标
位置
./target/release/memory-mcp-server
配置文件
.mcp.json
传输方式:stdio(标准输入/输出)

Available MCP Tools

可用MCP工具

ToolPurpose
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.
工具用途
query_memory
查询情景记忆以获取相关过往经历
analyze_patterns
从历史事件中分析模式
advanced_pattern_analysis
统计分析、预测建模
execute_agent_code
在沙箱中执行TypeScript/JavaScript代码
health_check
检查服务器健康状态
get_metrics
获取全面的监控指标
详细的工具文档请查看**tools.md,使用指南请查看best-practices.md**。

Starting the Server

启动服务器

bash
undefined
bash
undefined

Build

Build

cargo build --release --bin memory-mcp-server
cargo build --release --bin memory-mcp-server

Run directly

Run directly

export TURSO_DATABASE_URL="file:./data/memory.db" ./target/release/memory-mcp-server
export TURSO_DATABASE_URL="file:./data/memory.db" ./target/release/memory-mcp-server

Run via MCP Inspector for testing

Run via MCP Inspector for testing

npx -y @modelcontextprotocol/inspector ./target/release/memory-mcp-server

See **[configuration.md](configuration.md)** for full environment setup and **[validation.md](validation.md)** for MCP Inspector workflow.
npx -y @modelcontextprotocol/inspector ./target/release/memory-mcp-server

完整的环境设置请查看**[configuration.md](configuration.md)**,MCP Inspector流程请查看**[validation.md](validation.md)**。