Memory MCP

一个使用低级服务器实现和 SQLite 存储来存储和检索记忆的 Model Context Protocol 服务器。

安装

此项目使用 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]

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

memory-mcp

1. 在另一个终端中，使用 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

这有助于你确切了解发送到服务器以及从服务器接收的数据。

探索工具模式

要查看特定工具的模式：

> tool remember

这会显示工具的输入模式、所需参数和描述。

故障排除

如果遇到问题：

1. 检查服务器运行所在终端中的日志是否有错误消息。
2. 在 MCP inspect 终端中，使用 debug on 启用调试模式以查看原始请求和响应。
3. 确保工具参数与预期模式匹配（使用 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