记忆存储检索服务

存储器MCP

一个模型上下文协议服务器，用于使用低级服务器实现和SQLite存储来存储和检索内存。

安装

此项目使用 紫外线 用于依赖管理而不是pip。uv是一个快速、可靠的Python包安装程序和解析器。

使用紫外线进行安装：

uv pip install memory-mcp

或者直接从源代码安装：

uv pip install .

发展：

uv pip install -e ".[dev]"

如果你没有安装uv，你可以按照以下步骤安装它 官方指示.

用法

运行服务器

memory-mcp

这将启动允许您存储和检索内存的MCP服务器。

可用工具

内存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. 在一个终端中启动内存MCP服务器：

memory-mcp

3. 在另一个终端中，使用以下命令连接到正在运行的服务器 mcp inspect:

mcp inspect

使用MCP检查

连接后，您可以：

列出可用工具

> tools

这将显示内存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检查终端中，启用调试模式 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