Memory MCP

Memory MCP

一个用于存储和检索记忆的模型上下文协议服务，使用底层 Server 实现和 SQLite 存储。

安装

本项目使用 uv 管理依赖，而非 pip。uv 是一款快速、可靠的 Python 软件包安装器和解析器。

使用 uv 安装：

uv pip install memory-mcp

也可以直接从源代码安装：

uv pip install .

用于开发：

uv pip install -e ".[dev]"

如果尚未安装 uv，可按照官方说明进行安装。

使用方法

运行服务

memory-mcp

这将启动 MCP 服务，以便存储和检索记忆。

可用工具

Memory MCP 提供以下工具：

• remember：存储一条包含标题和内容的新记忆
• get_memory：按 ID 或标题检索指定记忆
• list_memories：列出所有已存储的记忆
• update_memory：更新已有记忆
• delete_memory：删除记忆

使用 MCP Inspect 调试

MCP 提供了一个便捷的命令行工具 mcp inspect，可用于直接调试并与 MCP 服务交互。

设置

1. 首先，确保已安装 MCP CLI 工具：

uv pip install mcp[cli]

2. 在一个终端中启动 Memory MCP 服务：

memory-mcp

3. 在另一个终端中，使用 mcp inspect 连接正在运行的服务：

mcp inspect

使用 MCP Inspect

连接后，你可以：

列出可用工具

> tools

这将显示 Memory MCP 服务提供的所有工具。

调用工具

要调用工具，请使用 call 命令，后接工具名称和所需参数：

> call remember title="Meeting Notes" content="Discussed project timeline and milestones."

> call list_memories

> call get_memory memory_id=1

> call update_memory memory_id=1 title="Updated Title" content="Updated content."

> call delete_memory memory_id=1

调试模式

你可以启用调试模式，查看详细的请求和响应信息：

> debug on

这有助于你准确了解发送到服务和从服务接收的数据。

查看工具 Schema

要查看特定工具的 schema：

> tool remember

其中会显示该工具的输入 schema、必需参数和描述。

故障排除

如果遇到问题：

1. 检查运行服务的终端中的服务日志，查看是否有错误消息。
2. 在 MCP inspect 终端中，使用 debug on 启用调试模式，以查看原始请求和响应。
3. 确保工具参数符合预期的 schema（使用 tool 命令检查）。
4. 如果服务崩溃，请检查服务终端中是否存在未捕获的异常。

开发

要为项目做贡献，请安装开发依赖：

uv pip install -e ".[dev]"

管理依赖

本项目使用 uv.lock 文件锁定依赖。要更新依赖：

uv pip compile pyproject.toml -o uv.lock

运行测试

python -m pytest

代码格式化

black memory_mcp tests

代码检查

ruff check memory_mcp tests

类型检查

mypy memory_mcp