记忆 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 检查进行调试

MCP 提供了一个名为 mcp inspect 的方便的命令行工具，用于直接调试和与你的 MCP 服务器交互。

设置

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

uv pip install mcp[cli]

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

memory-mcp

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

mcp inspect

使用 MCP 检查

连接后，你可以执行以下操作：

列出可用工具

> tools

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

调用工具

要调用工具，请使用 call 命令加上工具名称和任何所需的参数：

> call remember title="会议记录" content="讨论了项目的时间表和关键里程碑。"

> call list_memories

> call get_memory memory_id=1

> call update_memory memory_id=1 title="更新后的标题" content="更新后的内容。"

> call delete_memory memory_id=1

开发模式

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

> debug on

这有助于你了解服务器和客户端之间传输的确切数据。

探索工具架构

要查看特定工具的架构，请执行以下操作：

> tool remember

这将显示输入架构、所需参数和工具描述。

故障排除

如果遇到问题：

1. 检查正在运行服务器的终端中的服务器日志，获取任何错误信息。
2. 在 MCP 检查终端中启用调试模式 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